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 */
7 /* global $VARS, $CODE, RLQ:true, NORLQ:true */
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|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
&& NORLQ
[ 0 ] ) {
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.
117 $CODE
.registrations();
119 mw
.config
.set( $VARS
.configuration
);
120 // For the current page
121 mw
.config
.set( window
.RLCONF
|| {} );
122 mw
.loader
.state( window
.RLSTATE
|| {} );
123 mw
.loader
.load( window
.RLPAGEMODULES
|| [] );
125 // Process RLQ callbacks
127 // The code in these callbacks could've been exposed from load.php and
128 // requested client-side. Instead, they are pushed by the server directly
129 // (from ResourceLoaderClientHtml and other parts of MediaWiki). This
130 // saves the need for additional round trips. It also allows load.php
131 // to remain stateless and sending personal data in the HTML instead.
133 // The HTML inline script lazy-defines the 'RLQ' array. Now that we are
134 // processing it, replace it with an implementation where 'push' actually
135 // considers executing the code directly. This is to ensure any late
136 // arrivals will also be processed. Late arrival can happen because
137 // startup.js is executed asynchronously, concurrently with the streaming
138 // response of the HTML.
139 RLQ
= window
.RLQ
|| [];
140 RLQ
.push = function ( fn
) {
141 if ( typeof fn
=== 'function' ) {
144 // If the first parameter is not a function, then it is an array
145 // containing a list of required module names and a function.
146 // Do an actual push for now, as this signature is handled
147 // later by mediawiki.base.js.
148 RLQ
[ RLQ
.length
] = fn
;
152 // Process all values gathered so far
153 RLQ
.push( RLQ
.shift() );
156 // Clear and disable the Grade C queue