1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
/**
* This file is where we decide whether to initialise the modern support browser run-time.
*
* - Beware: This file MUST parse without errors on even the most ancient of browsers!
*/
/* eslint-disable no-implicit-globals */
/* global $CODE, RLQ:true, NORLQ:true */
/**
* See <https://www.mediawiki.org/wiki/Compatibility#Browsers>
*
* Browsers that pass these checks get served our modern run-time. This includes all Grade A
* browsers, and some Grade C and Grade X browsers.
*
* The following browsers are known to pass these checks:
* - Chrome 63+
* - Edge 79+
* - Opera 50+
* - Firefox 58+
* - Safari 11.1+
* - Mobile Safari 11.2+ (iOS 11+)
* - Android 5.0+
*
* @private
* @return {boolean} User agent is compatible with MediaWiki JS
*/
function isCompatible() {
return !!(
// Ensure DOM Level 4 features (including Selectors API).
//
// https://caniuse.com/#feat=queryselector
'querySelector' in document &&
// Ensure HTML 5 features (including Web Storage API)
//
// https://caniuse.com/#feat=namevalue-storage
// https://blog.whatwg.org/this-week-in-html-5-episode-30
'localStorage' in window &&
// Ensure ES2015 grammar and runtime API (a.k.a. ES6)
//
// In practice, Promise.finally is a good proxy for overall ES6 support and
// rejects most unsupporting browsers in one sweep. The feature itself
// was specified in ES2018, however.
// https://caniuse.com/promise-finally
// Chrome 63+, Edge 18+, Opera 50+, Safari 11.1+, Firefox 58+, iOS 11+
//
// eslint-disable-next-line es-x/no-promise, es-x/no-promise-prototype-finally, dot-notation
typeof Promise === 'function' && Promise.prototype[ 'finally' ] &&
// ES6 Arrow Functions (with default params), this ensures
// genuine syntax support for ES6 grammar, not just API coverage.
//
// https://caniuse.com/arrow-functions
// Chrome 45+, Safari 10+, Firefox 22+, Opera 32+
//
// Based on Benjamin De Cock's snippet here:
// https://gist.github.com/bendc/d7f3dbc83d0f65ca0433caf90378cd95
( function () {
try {
// eslint-disable-next-line no-new, no-new-func
new Function( '(a = 0) => a' );
return true;
} catch ( e ) {
return false;
}
}() ) &&
// ES6 RegExp.prototype.flags
//
// https://caniuse.com/mdn-javascript_builtins_regexp_flags
// Edge 79+ (Chromium-based, rejects MSEdgeHTML-based Edge <= 18)
//
// eslint-disable-next-line es-x/no-regexp-prototype-flags
/./g.flags === 'g'
);
}
if ( !isCompatible() ) {
// Handle basic supported browsers (Grade C).
// Undo speculative modern (Grade A) root CSS class `<html class="client-js">`.
// See ResourceLoaderClientHtml::getDocumentAttributes().
document.documentElement.className = document.documentElement.className
.replace( /(^|\s)client-js(\s|$)/, '$1client-nojs$2' );
// Process any callbacks for basic support (Grade C).
while ( window.NORLQ && NORLQ[ 0 ] ) {
NORLQ.shift()();
}
NORLQ = {
push: function ( fn ) {
fn();
}
};
// Clear and disable the modern (Grade A) queue.
RLQ = {
push: function () {}
};
} else {
// Handle modern (Grade A).
if ( window.performance && performance.mark ) {
performance.mark( 'mwStartup' );
}
// This embeds mediawiki.js, which defines 'mw' and 'mw.loader'.
$CODE.defineLoader();
/**
* The $CODE placeholder is substituted in ResourceLoaderStartUpModule.php.
*/
( function () {
/* global mw */
var queue;
$CODE.registrations();
// First set page-specific config needed by mw.loader (wgUserName)
mw.config.set( window.RLCONF || {} );
mw.loader.state( window.RLSTATE || {} );
mw.loader.load( window.RLPAGEMODULES || [] );
// Process RLQ callbacks
//
// The code in these callbacks could've been exposed from load.php and
// requested client-side. Instead, they are pushed by the server directly
// (from ResourceLoaderClientHtml and other parts of MediaWiki). This
// saves the need for additional round trips. It also allows load.php
// to remain stateless and sending personal data in the HTML instead.
//
// The HTML inline script lazy-defines the 'RLQ' array. Now that we are
// processing it, replace it with an implementation where 'push' actually
// considers executing the code directly. This is to ensure any late
// arrivals will also be processed. Late arrival can happen because
// startup.js is executed asynchronously, concurrently with the streaming
// response of the HTML.
queue = window.RLQ || [];
// Replace RLQ with an empty array, then process the things that were
// in RLQ previously. We have to do this to avoid an infinite loop:
// non-function items are added back to RLQ by the processing step.
RLQ = [];
RLQ.push = function ( fn ) {
if ( typeof fn === 'function' ) {
fn();
} else {
// If the first parameter is not a function, then it is an array
// containing a list of required module names and a function.
// Do an actual push for now, as this signature is handled
// later by mediawiki.base.js.
RLQ[ RLQ.length ] = fn;
}
};
while ( queue[ 0 ] ) {
// Process all values gathered so far
RLQ.push( queue.shift() );
}
// Clear and disable the basic (Grade C) queue.
NORLQ = {
push: function () {}
};
}() );
}
|
