currentscript
v1.1.1
Published
Polyfill of HTML5's `document.currentScript`
Downloads
186
Maintainers
Readme
document.currentScript
A polyfill of HTML5's document.currentScript
for IE 6-10 ONLY.
Public Service Announcement (PSA)
This polyfill will not work in IE11 because of a critical design choice made Microsoft ("Don't Call Me IE!") [1][2][3][4] in order to avoid consumers receiving an unnecessarily downgraded experience on websites that were making logic branch and feature decisions based on browser detection rather than feature detection.
However, Microsoft Edge (a.k.a. "Spartan", a.k.a. IE12) does natively support document.currentScript
. This is likely due in part to you lovely consumers upvoting this issue on the IE Platform Suggestion Forum, so thank you!
Overview
Strict
This polyfill is configured do its best to comply with the HTML spec's definition of the correct behavior for document.currentScript
.
More particularly, this will get the script
element that was the source of the nearest currently executing code but ONLY if said source script is being evaluated synchronously for the first time by the browser.
In other words, if code is being operated on after its initial evaluation (e.g. async callbacks, functions invoked by user actions, etc.), then document.currentScript
will always return null
.
Loose
If you are interested in getting the currently executing script [regardless of the source/trigger of the exection], take a look at JamesMGreene/currentExecutingScript instead.
Browser Compatibility
| Browser | Version | Works? | Notes |
|---------|---------:|:-----------:|---------------------------------------|
| IE | 6 | Yes | Must use document._currentScript()
. |
| IE | 7 | Yes | Must use document._currentScript()
. |
| IE | 8 | Yes | |
| IE | 9 | Yes | |
| IE | 10 | Yes | |
| IE | 11 | No! | IE removed script.readyState
but didn't add document.currentScript
yet! :astonished: See PSA for more info. |
| Edge | * | Yes | Natively supports document.currentScript
. |
| * | * | Maybe...? | Only if the browser natively supports document.currentScript
. |
Installation
NPM
npm install currentscript
GitHub
Alternatively, you can download/clone its GitHub repo: JamesMGreene/document.currentScript
Usage
IE 8-10
var scriptEl = document.currentScript;
IE 6-7
var scriptEl = document._currentScript();
Configuration
doNotDeferToNativeMethod
To support better cross-browser support, the default behavior of this polyfill in browsers other than IE 6-10 is to attempt to retrieve the native document.currentScript
accessor method and use it as a last-ditch fallback effort.
However, if you would prefer to disallow that fallback behavior, you can do so as follows:
document._currentScript.doNotDeferToNativeMethod = true;
Other Documentation
- MDN docs: https://developer.mozilla.org/en-US/docs/Web/API/document.currentScript
Errata
- Demo using old Gist: http://jsfiddle.net/JamesMGreene/9DFc9/
- Original location, old Gist: https://gist.github.com/JamesMGreene/fb4a71e060da6e26511d