html5 script for,GitHub - JamesMGreene/document.currentScript: Polyfill for HTML5's `document.curren...

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 execution], 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! 😲 See PSA for more info.

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

Errata