2 * This file is where we decide whether to initialise the Grade A run-time.
4 * - Beware: This file MUST parse without errors on even the most ancient of browsers!
6 /* eslint-disable no-implicit-globals, vars-on-top, no-unmodified-loop-condition */
7 /* global $VARS, $CODE */
10 * See <https://www.mediawiki.org/wiki/Compatibility#Browsers>
12 * Capabilities required for modern run-time:
14 * - DOM Level 4 & Selectors API Level 1
15 * - HTML5 & Web Storage
16 * - DOM Level 2 Events
18 * Browsers we support in our modern run-time (Grade A):
24 * - Mobile Safari 6.0+ (iOS 6+)
27 * Browsers we support in our no-javascript run-time (Grade C):
33 * - Mobile Safari 5.0+ (iOS 4+)
37 * - Symbian-based browsers
38 * - NetFront-based browser
40 * - Nokia's Ovi Browser
43 * - UC Mini (speed mode on)
45 * Other browsers that pass the check are considered Grade X.
48 * @param {string} ua User agent string
49 * @return {boolean} User agent is compatible with MediaWiki JS
51 function isCompatible( ua
) {
53 // https://caniuse.com/#feat=es5
54 // https://caniuse.com/#feat=use-strict
55 // https://caniuse.com/#feat=json / https://phabricator.wikimedia.org/T141344#2784065
58 return !this && Function
.prototype.bind
&& window
.JSON
;
61 // https://caniuse.com/#feat=queryselector
62 'querySelector' in document
&&
64 // https://caniuse.com/#feat=namevalue-storage
65 // https://developer.blackberry.com/html5/apis/v1_0/localstorage.html
66 // https://blog.whatwg.org/this-week-in-html-5-episode-30
67 'localStorage' in window
&&
69 // https://caniuse.com/#feat=addeventlistener
70 'addEventListener' in window
&&
72 // Hardcoded exceptions for browsers that pass the requirement but we don't
73 // want to support in the modern run-time.
75 // Please extend the regex instead of adding new ones!
76 // And add a test case to startup.test.js
77 !ua
.match( /MSIE 10|webOS\/1\.[0-4]|SymbianOS|Series60|NetFront|Opera Mini|S40OviBrowser|MeeGo|Android.+Glass|^Mozilla\/5\.0 .+ Gecko\/$|googleweblight|PLAYSTATION|PlayStation/ )
81 if ( !isCompatible( navigator
.userAgent
) ) {
83 // Undo speculative Grade A <html> class. See ResourceLoaderClientHtml::getDocumentAttributes().
84 document
.documentElement
.className
= document
.documentElement
.className
85 .replace( /(^|\s)client-js(\s|$)/, '$1client-nojs$2' );
87 // Process any callbacks for Grade C
88 while ( window
.NORLQ
&& window
.NORLQ
[ 0 ] ) {
89 window
.NORLQ
.shift()();
92 push: function ( fn
) {
97 // Clear and disable the Grade A queue
104 if ( window
.performance
&& performance
.mark
) {
105 performance
.mark( 'mwStartup' );
108 // This embeds mediawiki.js, which defines 'mw' and 'mw.loader'.
109 $CODE
.defineLoader();
112 * The $CODE and $VARS placeholders are substituted in ResourceLoaderStartUpModule.php.
116 mw
.config
= new mw
.Map( $VARS
.wgLegacyJavaScriptGlobals
);
118 $CODE
.registrations();
120 mw
.config
.set( $VARS
.configuration
);
122 // Process callbacks for Grade A
123 var queue
= window
.RLQ
;
124 // Replace RLQ placeholder from ResourceLoaderClientHtml with an implementation
125 // that executes simple callbacks, but continues to store callbacks that require
129 RLQ
.push = function ( fn
) {
130 if ( typeof fn
=== 'function' ) {
133 // This callback requires a module, handled in mediawiki.base.
134 RLQ
[ RLQ
.length
] = fn
;
137 while ( queue
&& queue
[ 0 ] ) {
138 // Re-use our new push() method
139 RLQ
.push( queue
.shift() );
142 // Clear and disable the Grade C queue