Release note for Id83eda95
[mediawiki.git] / resources / src / startup.js
blob312e7456988461b24eb9bab7950e7b8b28902177
1 /**
2 * Code in this file MUST work on even the most ancient of browsers!
4 * This file is where we decide whether to initialise the modern run-time.
5 */
6 /*jshint unused: false, evil: true */
7 /*globals mw, RLQ: true, NORLQ: true, $VARS, $CODE, performance */
9 var mediaWikiLoadStart = ( new Date() ).getTime(),
11 mwPerformance = ( window.performance && performance.mark ) ? performance : {
12 mark: function () {}
15 mwPerformance.mark( 'mwLoadStart' );
17 /**
18 * See <https://www.mediawiki.org/wiki/Compatibility#Browsers>
20 * Capabilities required for modern run-time:
21 * - DOM Level 4 & Selectors API Level 1
22 * - HTML5 & Web Storage
23 * - DOM Level 2 Events
25 * Browsers we support in our modern run-time (Grade A):
26 * - Chrome
27 * - IE 9+
28 * - Firefox 3.5+
29 * - Safari 4+
30 * - Opera 10.5+
31 * - Mobile Safari (iOS 1+)
32 * - Android 2.0+
34 * Browsers we support in our no-javascript run-time (Grade C):
35 * - IE 6+
36 * - Firefox 3+
37 * - Safari 3+
38 * - Opera 10+
39 * - WebOS < 1.5
40 * - PlayStation
41 * - Symbian-based browsers
42 * - NetFront-based browser
43 * - Opera Mini
44 * - Nokia's Ovi Browser
45 * - MeeGo's browser
46 * - Google Glass
48 * Other browsers that pass the check are considered Grade X.
50 function isCompatible( str ) {
51 var ua = str || navigator.userAgent;
52 return !!(
53 // http://caniuse.com/#feat=queryselector
54 'querySelector' in document
56 // http://caniuse.com/#feat=namevalue-storage
57 // https://developer.blackberry.com/html5/apis/v1_0/localstorage.html
58 // https://blog.whatwg.org/this-week-in-html-5-episode-30
59 && 'localStorage' in window
61 // http://caniuse.com/#feat=addeventlistener
62 && 'addEventListener' in window
64 // Hardcoded exceptions for browsers that pass the requirement but we don't want to
65 // support in the modern run-time.
66 && !(
67 ua.match( /webOS\/1\.[0-4]/ ) ||
68 ua.match( /PlayStation/i ) ||
69 ua.match( /SymbianOS|Series60|NetFront|Opera Mini|S40OviBrowser|MeeGo/ ) ||
70 ( ua.match( /Glass/ ) && ua.match( /Android/ ) )
75 // Conditional script injection
76 ( function () {
77 var NORLQ, script;
78 if ( !isCompatible() ) {
79 // Undo class swapping in case of an unsupported browser.
80 // See OutputPage::getHeadScripts().
81 document.documentElement.className = document.documentElement.className
82 .replace( /(^|\s)client-js(\s|$)/, '$1client-nojs$2' );
84 NORLQ = window.NORLQ || [];
85 while ( NORLQ.length ) {
86 NORLQ.shift()();
88 window.NORLQ = {
89 push: function ( fn ) {
90 fn();
94 // Clear and disable the other queue
95 window.RLQ = {
96 // No-op
97 push: function () {}
100 return;
104 * The $CODE and $VARS placeholders are substituted in ResourceLoaderStartUpModule.php.
106 function startUp() {
107 mw.config = new mw.Map( $VARS.wgLegacyJavaScriptGlobals );
109 $CODE.registrations();
111 mw.config.set( $VARS.configuration );
113 // Must be after mw.config.set because these callbacks may use mw.loader which
114 // needs to have values 'skin', 'debug' etc. from mw.config.
115 var RLQ = window.RLQ || [];
116 while ( RLQ.length ) {
117 RLQ.shift()();
119 window.RLQ = {
120 push: function ( fn ) {
121 fn();
125 // Clear and disable the other queue
126 window.NORLQ = {
127 // No-op
128 push: function () {}
132 script = document.createElement( 'script' );
133 script.src = $VARS.baseModulesUri;
134 script.onload = script.onreadystatechange = function () {
135 if ( !script.readyState || /loaded|complete/.test( script.readyState ) ) {
136 // Clean up
137 script.onload = script.onreadystatechange = null;
138 script = null;
139 // Callback
140 startUp();
143 document.getElementsByTagName( 'head' )[ 0 ].appendChild( script );
144 }() );