Page MenuHomeWickedGov Phorge
Files F1431482

mediawiki.inspect.js
No OneTemporary
Actions

Size
10 KB
Referenced Files
None
Subscribers
None

mediawiki.inspect.js
View Options

/*!
* The mediawiki.inspect module.
*
* @author Ori Livneh
* @since 1.22
*/
/* eslint-disable no-console */
( function () {
// mw.inspect is a singleton class with static methods
// that itself can also be invoked as a function (mediawiki.base/mw#inspect).
// In JavaScript, that is implemented by starting with a function,
// and subsequently setting additional properties on the function object.
/**
* @classdesc Tools for inspecting page composition and performance.
*
* @class mediawiki.inspect
* @hideconstructor
*/
const inspect = mw.inspect,
byteLength = require( 'mediawiki.String' ).byteLength,
hasOwn = Object.prototype.hasOwnProperty;
function sortByProperty( array, prop, descending ) {
const order = descending ? -1 : 1;
return array.sort( ( a, b ) => {
if ( a[ prop ] === undefined || b[ prop ] === undefined ) {
// Sort undefined to the end, regardless of direction
return a[ prop ] !== undefined ? -1 : b[ prop ] !== undefined ? 1 : 0;
}
return a[ prop ] > b[ prop ] ? order : a[ prop ] < b[ prop ] ? -order : 0;
} );
}
function humanSize( bytesInput ) {
let bytes = +bytesInput;
const units = [ '', ' KiB', ' MiB', ' GiB', ' TiB', ' PiB' ];
if ( bytes === 0 || isNaN( bytes ) ) {
return bytesInput;
}
let i;
for ( i = 0; bytes >= 1024; bytes /= 1024 ) {
i++;
}
// Maintain one decimal for KiB and above, but don't
// add ".0" for bytes.
return bytes.toFixed( i > 0 ? 1 : 0 ) + units[ i ];
}
/**
* Return a map of all dependency relationships between loaded modules.
*
* @return {Object} Maps module names to objects. Each sub-object has
* two properties, 'requires' and 'requiredBy'.
* @memberof mediawiki.inspect
* @method mediawiki.inspect.getDependencyGraph
*/
inspect.getDependencyGraph = function () {
const modules = inspect.getLoadedModules(),
graph = {};
modules.forEach( ( moduleName ) => {
const dependencies = mw.loader.moduleRegistry[ moduleName ].dependencies || [];
if ( !hasOwn.call( graph, moduleName ) ) {
graph[ moduleName ] = { requiredBy: [] };
}
graph[ moduleName ].requires = dependencies;
dependencies.forEach( ( depName ) => {
if ( !hasOwn.call( graph, depName ) ) {
graph[ depName ] = { requiredBy: [] };
}
graph[ depName ].requiredBy.push( moduleName );
} );
} );
return graph;
};
/**
* Calculate the byte size of a ResourceLoader module.
*
* @param {string} moduleName The name of the module
* @return {number|null} Module size in bytes or null
* @memberof mediawiki.inspect
* @method mediawiki.inspect.getModuleSize
*/
inspect.getModuleSize = function ( moduleName ) {
// We typically receive them from the server through batches from load.php,
// or embedded as inline scripts (handled in PHP by ResourceLoader::makeModuleResponse
// and ResourceLoader\ClientHtml respectively).
//
// The module declarator function is stored by mw.loader.implement(), allowing easy
// computation of the exact size.
const module = mw.loader.moduleRegistry[ moduleName ];
if ( module.state !== 'ready' ) {
return null;
}
if ( !module.declarator ) {
return 0;
}
return byteLength( module.declarator.toString() );
};
/**
* Given CSS source, count both the total number of selectors it
* contains and the number which match some element in the current
* document.
*
* @param {string} css CSS source
* @return {Object} Selector counts
* @return {number} return.selectors Total number of selectors
* @return {number} return.matched Number of matched selectors
* @memberof mediawiki.inspect
* @method mediawiki.inspect.auditSelectors
*/
inspect.auditSelectors = function ( css ) {
const selectors = { total: 0, matched: 0 },
style = document.createElement( 'style' );
style.textContent = css;
document.body.appendChild( style );
const cssRules = style.sheet.cssRules;
for ( const index in cssRules ) {
const rule = cssRules[ index ];
selectors.total++;
// document.querySelector() on prefixed pseudo-elements can throw exceptions
// in Firefox and Safari. Ignore these exceptions.
// https://bugs.webkit.org/show_bug.cgi?id=149160
// https://bugzilla.mozilla.org/show_bug.cgi?id=1204880
try {
if ( document.querySelector( rule.selectorText ) !== null ) {
selectors.matched++;
}
} catch ( e ) {}
}
document.body.removeChild( style );
return selectors;
};
/**
* Get a list of all loaded ResourceLoader modules.
*
* @return {Array} List of module names
* @memberof mediawiki.inspect
* @method mediawiki.inspect.getLoadedModules
*/
inspect.getLoadedModules = function () {
return mw.loader.getModuleNames().filter( ( module ) => mw.loader.getState( module ) === 'ready' );
};
/**
* Print tabular data to the console using console.table.
*
* @param {Array} data Tabular data represented as an array of objects
* with common properties.
* @memberof mediawiki.inspect
* @method mediawiki.inspect.dumpTable
*/
inspect.dumpTable = console.table;
/**
* Generate and print reports.
*
* When invoked without arguments, prints all available reports.
*
* @param {...string} [reports] One or more of "size", "css", "store", or "time".
* @memberof mediawiki.inspect
* @method mediawiki.inspect.runReports
*/
inspect.runReports = function () {
const reports = arguments.length > 0 ?
Array.prototype.slice.call( arguments ) :
Object.keys( inspect.reports );
reports.forEach( ( name ) => {
if ( console.group ) {
console.group( 'mw.inspect ' + name + ' report' );
} else {
console.log( 'mw.inspect ' + name + ' report' );
}
inspect.dumpTable( inspect.reports[ name ]() );
if ( console.group ) {
console.groupEnd( 'mw.inspect ' + name + ' report' );
}
} );
};
/**
* Perform a string search across the JavaScript and CSS source code
* of all loaded modules and return an array of the names of the
* modules that matched.
*
* @param {string|RegExp} pattern String or regexp to match.
* @return {Array} Array of the names of modules that matched.
* @memberof mediawiki.inspect
* @method mediawiki.inspect.grep
*/
inspect.grep = function ( pattern ) {
if ( typeof pattern.test !== 'function' ) {
pattern = new RegExp( mw.util.escapeRegExp( pattern ), 'g' );
}
return inspect.getLoadedModules().filter( ( moduleName ) => {
const module = mw.loader.moduleRegistry[ moduleName ];
// Grep module's JavaScript
if ( typeof module.script === 'function' && pattern.test( module.script.toString() ) ) {
return true;
}
// Grep module's CSS
if (
$.isPlainObject( module.style ) && Array.isArray( module.style.css ) &&
pattern.test( module.style.css.join( '' ) )
) {
// Module's CSS source matches
return true;
}
return false;
} );
};
/**
* @private
* @class mw.inspect.reports
* @singleton
*/
inspect.reports = {
/**
* Generate a breakdown of all loaded modules and their size in
* kibibytes. Modules are ordered from largest to smallest.
*
* @return {Object[]} Size reports
*/
size: function () {
// Map each module to a descriptor object.
const modules = inspect.getLoadedModules().map( ( module ) => ( {
name: module,
size: inspect.getModuleSize( module )
} ) );
// Sort module descriptors by size, largest first.
sortByProperty( modules, 'size', true );
// Convert size to human-readable string.
modules.forEach( ( module ) => {
module.sizeInBytes = module.size;
module.size = humanSize( module.size );
} );
return modules;
},
/**
* For each module with styles, count the number of selectors, and
* count how many match against some element currently in the DOM.
*
* @return {Object[]} CSS reports
*/
css: function () {
const modules = [];
inspect.getLoadedModules().forEach( ( name ) => {
const module = mw.loader.moduleRegistry[ name ];
let css;
try {
css = module.style.css.join();
} catch ( e ) {
// skip
return;
}
const stats = inspect.auditSelectors( css );
modules.push( {
module: name,
allSelectors: stats.total,
matchedSelectors: stats.matched,
percentMatched: stats.total !== 0 ?
( stats.matched / stats.total * 100 ).toFixed( 2 ) + '%' : null
} );
} );
sortByProperty( modules, 'allSelectors', true );
return modules;
},
/**
* Report stats on mw.loader.store: the number of localStorage
* cache hits and misses, the number of items purged from the
* cache, and the total size of the module blob in localStorage.
*
* @return {Object[]} Store stats
*/
store: function () {
const stats = { enabled: mw.loader.store.enabled };
if ( stats.enabled ) {
Object.assign( stats, mw.loader.store.stats );
try {
const raw = localStorage.getItem( mw.loader.store.key );
stats.totalSizeInBytes = byteLength( raw );
stats.totalSize = humanSize( byteLength( raw ) );
} catch ( e ) {}
}
return [ stats ];
},
/**
* Generate a breakdown of all loaded modules and their time
* spent during initialisation (measured in milliseconds).
*
* This timing data is collected by mw.loader.profiler.
*
* @return {Object[]} Table rows
*/
time: function () {
if ( !mw.loader.profiler ) {
mw.log.warn( 'mw.inspect: The time report requires $wgResourceLoaderEnableJSProfiler.' );
return [];
}
const modules = inspect.getLoadedModules()
.map( ( moduleName ) => mw.loader.profiler.getProfile( moduleName ) )
.filter(
// Exclude modules that reached "ready" state without involvement from mw.loader.
// This is primarily styles-only as loaded via <link rel="stylesheet">.
( perf ) => perf !== null
);
// Sort by total time spent, highest first.
sortByProperty( modules, 'total', true );
// Add human-readable strings
modules.forEach( ( module ) => {
module.totalInMs = module.total;
module.total = module.totalInMs.toLocaleString() + ' ms';
} );
return modules;
}
};
if ( mw.config.get( 'debug' ) ) {
mw.log( 'mw.inspect: reports are not available in debug mode.' );
}
}() );

File Metadata

Mime Type
text/plain
Expires
Sat, May 16, 20:32 (1 d, 3 h)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
ef/25/d4e54b014e2754da3c5d8851b5a0
Default Alt Text
mediawiki.inspect.js (10 KB)

Event Timeline