Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
/*!
|
2015-12-10 16:07:50 +00:00
|
|
|
* VisualEditor MediaWiki ArticleTargetLoader.
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
*
|
2023-12-01 16:06:11 +00:00
|
|
|
* @copyright See AUTHORS.txt
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
|
|
|
*/
|
|
|
|
|
|
2019-07-22 20:33:15 +00:00
|
|
|
// TODO: ve.now and ve.track should be moved to mw.libs.ve
|
|
|
|
|
/* global ve */
|
|
|
|
|
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
/**
|
|
|
|
|
* Target loader.
|
|
|
|
|
*
|
|
|
|
|
* Light-weight loader that loads ResourceLoader modules for VisualEditor
|
|
|
|
|
* and HTML and page data from the API. Also handles plugin registration.
|
|
|
|
|
*
|
|
|
|
|
* @class mw.libs.ve.targetLoader
|
|
|
|
|
* @singleton
|
2024-04-30 11:02:45 +00:00
|
|
|
* @hideconstructor
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
*/
|
|
|
|
|
( function () {
|
2024-05-21 14:22:56 +00:00
|
|
|
const conf = mw.config.get( 'wgVisualEditorConfig' ),
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
pluginCallbacks = [],
|
2024-05-29 16:03:23 +00:00
|
|
|
modules = [
|
|
|
|
|
'ext.visualEditor.articleTarget',
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
// Add modules from $wgVisualEditorPluginModules
|
2024-05-29 16:03:23 +00:00
|
|
|
...conf.pluginModules.filter( mw.loader.getState )
|
|
|
|
|
];
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
const url = new URL( location.href );
|
2016-09-01 19:04:54 +00:00
|
|
|
// Provide the new wikitext editor
|
2016-10-04 22:48:43 +00:00
|
|
|
if (
|
2024-08-26 17:55:55 +00:00
|
|
|
mw.user.options.get( 'visualeditor-newwikitext' ) ||
|
|
|
|
|
url.searchParams.get( 'veaction' ) === 'editsource'
|
2016-10-04 22:48:43 +00:00
|
|
|
) {
|
2016-05-26 12:08:26 +00:00
|
|
|
modules.push( 'ext.visualEditor.mwwikitext' );
|
|
|
|
|
}
|
|
|
|
|
|
2024-02-13 17:34:18 +00:00
|
|
|
// A/B test enrollment for edit check (T342930)
|
|
|
|
|
if ( conf.editCheckABTest ) {
|
2024-05-21 14:22:56 +00:00
|
|
|
let inABTest;
|
2024-02-13 17:34:18 +00:00
|
|
|
if ( mw.user.isAnon() ) {
|
|
|
|
|
// can't just use mw.user.sessionId() because we need this to last across sessions
|
2024-05-21 14:22:56 +00:00
|
|
|
const token = mw.cookie.get( 'VEECid', '', mw.user.generateRandomSessionId() );
|
2024-02-13 17:34:18 +00:00
|
|
|
// Store the token so our state is consistent across pages
|
|
|
|
|
mw.cookie.set( 'VEECid', token, { path: '/', expires: 90 * 86400, prefix: '' } );
|
|
|
|
|
inABTest = parseInt( token.slice( 0, 8 ), 16 ) % 2 === 1;
|
|
|
|
|
} else {
|
|
|
|
|
inABTest = mw.user.getId() % 2 === 1;
|
|
|
|
|
}
|
|
|
|
|
conf.editCheck = inABTest;
|
|
|
|
|
// Communicate the bucket to instrumentation:
|
|
|
|
|
mw.config.set( 'wgVisualEditorEditCheckABTestBucket', '2024-02-editcheck-reference-' + ( inABTest ? 'test' : 'control' ) );
|
|
|
|
|
}
|
|
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
const editCheck = conf.editCheck || !!url.searchParams.get( 'ecenable' ) || !!window.MWVE_FORCE_EDIT_CHECK_ENABLED;
|
2023-09-05 13:34:20 +00:00
|
|
|
if ( conf.editCheckTagging || editCheck ) {
|
2023-03-16 15:25:06 +00:00
|
|
|
modules.push( 'ext.visualEditor.editCheck' );
|
|
|
|
|
}
|
|
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
const namespaces = mw.config.get( 'wgNamespaceIds' );
|
2018-11-27 17:34:39 +00:00
|
|
|
// Load signature tool if *any* namespace supports it.
|
|
|
|
|
// It will be shown disabled on namespaces that don't support it.
|
|
|
|
|
if (
|
2024-04-30 16:44:25 +00:00
|
|
|
Object.keys( namespaces ).some( ( name ) => mw.Title.wantSignaturesNamespace( namespaces[ name ] ) )
|
2018-11-27 17:34:39 +00:00
|
|
|
) {
|
2015-11-08 17:05:33 +00:00
|
|
|
modules.push( 'ext.visualEditor.mwsignature' );
|
|
|
|
|
}
|
|
|
|
|
|
2015-03-18 00:38:29 +00:00
|
|
|
mw.libs.ve = mw.libs.ve || {};
|
|
|
|
|
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
mw.libs.ve.targetLoader = {
|
|
|
|
|
/**
|
|
|
|
|
* Add a plugin module or callback.
|
|
|
|
|
*
|
|
|
|
|
* If a module name is passed, that module will be loaded alongside the other modules.
|
|
|
|
|
*
|
|
|
|
|
* If a callback is passed, it will be executed after the modules have loaded. The callback
|
|
|
|
|
* may optionally return a jQuery.Promise; if it does, loading won't be complete until
|
|
|
|
|
* that promise is resolved.
|
|
|
|
|
*
|
|
|
|
|
* @param {string|Function} plugin Plugin module name or callback
|
|
|
|
|
*/
|
|
|
|
|
addPlugin: function ( plugin ) {
|
|
|
|
|
if ( typeof plugin === 'string' ) {
|
|
|
|
|
modules.push( plugin );
|
2018-11-21 12:33:32 +00:00
|
|
|
} else {
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
pluginCallbacks.push( plugin );
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Load modules needed for VisualEditor, as well as plugins.
|
|
|
|
|
*
|
|
|
|
|
* This loads the base VE modules as well as any registered plugin modules.
|
|
|
|
|
* Once those are loaded, any registered plugin callbacks are executed,
|
|
|
|
|
* and we wait for all promises returned by those callbacks to resolve.
|
|
|
|
|
*
|
2017-12-07 11:14:00 +00:00
|
|
|
* @param {string} mode Initial editor mode, for tracking
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
* @return {jQuery.Promise} Promise resolved when the loading process is complete
|
|
|
|
|
*/
|
2017-12-07 11:14:00 +00:00
|
|
|
loadModules: function ( mode ) {
|
2020-11-03 00:14:44 +00:00
|
|
|
mw.hook( 've.loadModules' ).fire( this.addPlugin.bind( this ) );
|
2017-12-07 11:14:00 +00:00
|
|
|
ve.track( 'trace.moduleLoad.enter', { mode: mode } );
|
2015-04-03 20:38:39 +00:00
|
|
|
return mw.loader.using( modules )
|
2024-04-30 16:44:25 +00:00
|
|
|
.then( () => {
|
2017-12-07 11:14:00 +00:00
|
|
|
ve.track( 'trace.moduleLoad.exit', { mode: mode } );
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
pluginCallbacks.push( ve.init.platform.getInitializedPromise.bind( ve.init.platform ) );
|
|
|
|
|
// Execute plugin callbacks and collect promises
|
2024-04-30 16:44:25 +00:00
|
|
|
return $.when.apply( $, pluginCallbacks.map( ( callback ) => {
|
2023-08-15 16:12:31 +00:00
|
|
|
try {
|
|
|
|
|
return callback();
|
|
|
|
|
} catch ( e ) {
|
|
|
|
|
mw.log.warn( 'Failed to load VE plugin:', e );
|
|
|
|
|
return null;
|
|
|
|
|
}
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
} ) );
|
|
|
|
|
} );
|
2015-03-13 15:50:23 +00:00
|
|
|
},
|
|
|
|
|
|
2020-03-04 15:07:42 +00:00
|
|
|
/**
|
|
|
|
|
* Creates an OOUI checkbox inside an inline field layout
|
|
|
|
|
*
|
|
|
|
|
* @param {Object[]} checkboxesDef Checkbox definitions from the API
|
2021-01-14 15:59:25 +00:00
|
|
|
* @param {Object} [widgetConfig] Additional widget config
|
2020-03-04 15:07:42 +00:00
|
|
|
* @return {Object} Result object with checkboxFields (OO.ui.FieldLayout[]) and
|
|
|
|
|
* checkboxesByName (keyed object of OO.ui.CheckboxInputWidget).
|
|
|
|
|
*/
|
2021-01-14 15:59:25 +00:00
|
|
|
createCheckboxFields: function ( checkboxesDef, widgetConfig ) {
|
2024-05-21 14:22:56 +00:00
|
|
|
const checkboxFields = [],
|
2020-03-04 15:07:42 +00:00
|
|
|
checkboxesByName = {};
|
|
|
|
|
|
|
|
|
|
if ( checkboxesDef ) {
|
2024-04-30 16:44:25 +00:00
|
|
|
Object.keys( checkboxesDef ).forEach( ( name ) => {
|
2024-05-21 16:40:36 +00:00
|
|
|
const options = checkboxesDef[ name ];
|
|
|
|
|
let accesskey = null,
|
2020-03-04 15:07:42 +00:00
|
|
|
title = null;
|
|
|
|
|
|
|
|
|
|
// The messages documented below are just the ones defined in core.
|
|
|
|
|
// Extensions may add other checkboxes.
|
|
|
|
|
if ( options.tooltip ) {
|
|
|
|
|
// The following messages are used here:
|
|
|
|
|
// * accesskey-minoredit
|
|
|
|
|
// * accesskey-watch
|
|
|
|
|
accesskey = mw.message( 'accesskey-' + options.tooltip ).text();
|
|
|
|
|
// The following messages are used here:
|
|
|
|
|
// * tooltip-minoredit
|
|
|
|
|
// * tooltip-watch
|
|
|
|
|
title = mw.message( 'tooltip-' + options.tooltip ).text();
|
|
|
|
|
}
|
|
|
|
|
if ( options[ 'title-message' ] ) {
|
|
|
|
|
// Not used in core
|
|
|
|
|
// eslint-disable-next-line mediawiki/msg-doc
|
|
|
|
|
title = mw.message( options[ 'title-message' ] ).text();
|
|
|
|
|
}
|
|
|
|
|
// The following messages are used here:
|
|
|
|
|
// * minoredit
|
|
|
|
|
// * watchthis
|
2024-05-21 14:22:56 +00:00
|
|
|
const $label = mw.message( options[ 'label-message' ] ).parseDom();
|
2020-03-04 15:07:42 +00:00
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
const config = $.extend( {
|
2020-03-04 15:07:42 +00:00
|
|
|
accessKey: accesskey,
|
2020-04-09 13:33:54 +00:00
|
|
|
// The following classes are used here:
|
|
|
|
|
// * ve-ui-mwSaveDialog-checkbox-wpMinoredit
|
|
|
|
|
// * ve-ui-mwSaveDialog-checkbox-wpWatchthis
|
2021-01-14 15:59:25 +00:00
|
|
|
// * ve-ui-mwSaveDialog-checkbox-wpWatchlistExpiry
|
2020-03-04 15:07:42 +00:00
|
|
|
classes: [ 've-ui-mwSaveDialog-checkbox-' + name ]
|
2021-01-14 15:59:25 +00:00
|
|
|
}, widgetConfig );
|
|
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
let checkbox;
|
2021-01-14 15:59:25 +00:00
|
|
|
switch ( options.class ) {
|
|
|
|
|
case 'OOUI\\DropdownInputWidget':
|
|
|
|
|
checkbox = new OO.ui.DropdownInputWidget( $.extend( config, {
|
|
|
|
|
value: options.default,
|
|
|
|
|
options: options.options
|
|
|
|
|
} ) );
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
default:
|
|
|
|
|
checkbox = new OO.ui.CheckboxInputWidget( $.extend( config, {
|
|
|
|
|
selected: options.default
|
|
|
|
|
} ) );
|
|
|
|
|
break;
|
|
|
|
|
}
|
2020-03-04 15:07:42 +00:00
|
|
|
|
|
|
|
|
checkboxFields.push(
|
|
|
|
|
new OO.ui.FieldLayout( checkbox, {
|
|
|
|
|
align: 'inline',
|
2021-08-31 13:58:44 +00:00
|
|
|
label: $label,
|
2021-01-14 15:59:25 +00:00
|
|
|
title: title,
|
|
|
|
|
invisibleLabel: !!options.invisibleLabel,
|
|
|
|
|
// * ve-ui-mwSaveDialog-field-wpMinoredit
|
|
|
|
|
// * ve-ui-mwSaveDialog-field-wpWatchthis
|
|
|
|
|
// * ve-ui-mwSaveDialog-field-wpWatchlistExpiry
|
|
|
|
|
classes: [ 've-ui-mwSaveDialog-field-' + name ]
|
2020-03-04 15:07:42 +00:00
|
|
|
} )
|
|
|
|
|
);
|
|
|
|
|
checkboxesByName[ name ] = checkbox;
|
|
|
|
|
} );
|
|
|
|
|
}
|
|
|
|
|
return {
|
|
|
|
|
checkboxFields: checkboxFields,
|
|
|
|
|
checkboxesByName: checkboxesByName
|
|
|
|
|
};
|
|
|
|
|
},
|
|
|
|
|
|
2015-03-13 15:50:23 +00:00
|
|
|
/**
|
2017-01-02 18:40:07 +00:00
|
|
|
* Request the page data and various metadata from the MediaWiki API (which will use
|
2015-09-14 16:13:31 +00:00
|
|
|
* Parsoid or RESTBase).
|
2015-08-19 18:21:01 +00:00
|
|
|
*
|
2016-05-26 12:08:26 +00:00
|
|
|
* @param {string} mode Target mode: 'visual' or 'source'
|
2019-03-08 21:46:10 +00:00
|
|
|
* @param {string} pageName Page name to request, in prefixed DB key form (underscores instead of spaces)
|
2021-06-04 11:58:18 +00:00
|
|
|
* @param {Object} [options]
|
2018-02-21 22:58:50 +00:00
|
|
|
* @param {boolean} [options.sessionStore] Store result in session storage (by page+mode+section) for auto-save
|
2020-03-31 20:04:30 +00:00
|
|
|
* @param {null|string} [options.section] Section to edit; number, 'T-'-prefixed, null or 'new' (currently just source mode)
|
2017-09-11 14:53:50 +00:00
|
|
|
* @param {number} [options.oldId] Old revision ID. Current if omitted.
|
|
|
|
|
* @param {string} [options.targetName] Optional target name for tracking
|
2023-05-29 00:10:55 +00:00
|
|
|
* @param {boolean} [options.modified] The page has been modified before loading (e.g. in source mode)
|
2017-09-11 14:53:50 +00:00
|
|
|
* @param {string} [options.wikitext] Wikitext to convert to HTML. The original document is fetched if undefined.
|
2020-12-03 23:16:19 +00:00
|
|
|
* @param {string} [options.editintro] Name of a page to use as edit intro message
|
2020-04-15 18:08:21 +00:00
|
|
|
* @param {string} [options.preload] Name of a page to use as preloaded content if pageName is empty
|
2023-05-29 00:10:55 +00:00
|
|
|
* @param {string[]} [options.preloadparams] Parameters to substitute into preload if it's used
|
2015-03-13 15:50:23 +00:00
|
|
|
* @return {jQuery.Promise} Abortable promise resolved with a JSON object
|
|
|
|
|
*/
|
2017-09-11 14:53:50 +00:00
|
|
|
requestPageData: function ( mode, pageName, options ) {
|
2018-05-20 10:53:19 +00:00
|
|
|
options = options || {};
|
2024-05-21 14:22:56 +00:00
|
|
|
const apiRequest = mode === 'source' ?
|
2018-05-20 10:53:19 +00:00
|
|
|
this.requestWikitext.bind( this, pageName, options ) :
|
|
|
|
|
this.requestParsoidData.bind( this, pageName, options );
|
2018-02-21 22:58:50 +00:00
|
|
|
|
|
|
|
|
if ( options.sessionStore ) {
|
2024-05-21 14:22:56 +00:00
|
|
|
let sessionState;
|
2018-02-21 22:58:50 +00:00
|
|
|
try {
|
2018-09-24 11:41:58 +00:00
|
|
|
// ve.init.platform.getSessionObject is not available yet
|
2018-02-21 22:58:50 +00:00
|
|
|
sessionState = JSON.parse( mw.storage.session.get( 've-docstate' ) );
|
|
|
|
|
} catch ( e ) {}
|
|
|
|
|
|
|
|
|
|
if ( sessionState ) {
|
2024-05-21 14:22:56 +00:00
|
|
|
const request = sessionState.request || {};
|
2019-02-13 13:21:26 +00:00
|
|
|
// Check true section editing is in use
|
2024-05-21 14:22:56 +00:00
|
|
|
const enableVisualSectionEditing = conf.enableVisualSectionEditing;
|
|
|
|
|
const section = request.mode === 'source' || enableVisualSectionEditing === true || enableVisualSectionEditing === options.targetName ?
|
2019-02-13 13:21:26 +00:00
|
|
|
options.section : null;
|
2018-02-21 22:58:50 +00:00
|
|
|
// Check the requested page, mode and section match the stored one
|
|
|
|
|
if (
|
|
|
|
|
request.pageName === pageName &&
|
|
|
|
|
request.mode === mode &&
|
2019-02-13 13:21:26 +00:00
|
|
|
request.section === section
|
2018-02-21 22:58:50 +00:00
|
|
|
// NB we don't cache by oldid so that cached results can be recovered
|
|
|
|
|
// even if the page has been since edited
|
|
|
|
|
) {
|
2024-05-21 14:22:56 +00:00
|
|
|
const dataPromise = $.Deferred().resolve( {
|
2018-02-21 22:58:50 +00:00
|
|
|
visualeditor: $.extend(
|
|
|
|
|
{ content: mw.storage.session.get( 've-dochtml' ) },
|
|
|
|
|
sessionState.response,
|
|
|
|
|
{ recovered: true }
|
|
|
|
|
)
|
|
|
|
|
} ).promise();
|
2018-03-13 12:51:44 +00:00
|
|
|
// If the document hasn't been edited since the user first loaded it, recover
|
|
|
|
|
// their changes automatically.
|
|
|
|
|
if ( sessionState.response.oldid === mw.config.get( 'wgCurRevisionId' ) ) {
|
|
|
|
|
return dataPromise;
|
|
|
|
|
} else {
|
|
|
|
|
// Otherwise, prompt them if they want to recover, or reload the document
|
|
|
|
|
// to see the latest version
|
|
|
|
|
// This prompt will throw off all of our timing data, so just disable tracking
|
|
|
|
|
// for this session
|
|
|
|
|
ve.track = function () {};
|
2024-04-30 16:44:25 +00:00
|
|
|
return mw.loader.using( 'oojs-ui-windows' ).then( () => OO.ui.confirm( mw.msg( 'visualeditor-autosave-modified-prompt-message' ), {
|
|
|
|
|
title: mw.msg( 'visualeditor-autosave-modified-prompt-title' ),
|
|
|
|
|
actions: [
|
|
|
|
|
{ action: 'accept', label: mw.msg( 'visualeditor-autosave-modified-prompt-accept' ), flags: [ 'primary', 'progressive' ] },
|
|
|
|
|
{ action: 'reject', label: mw.msg( 'visualeditor-autosave-modified-prompt-reject' ), flags: 'destructive' }
|
|
|
|
|
] }
|
|
|
|
|
).then( ( confirmed ) => {
|
|
|
|
|
if ( confirmed ) {
|
|
|
|
|
return dataPromise;
|
|
|
|
|
} else {
|
|
|
|
|
// If they requested the latest version, invalidate the autosave state
|
|
|
|
|
mw.storage.session.remove( 've-docstate' );
|
|
|
|
|
return apiRequest();
|
|
|
|
|
}
|
|
|
|
|
} ) );
|
2018-03-13 12:51:44 +00:00
|
|
|
}
|
2018-02-21 22:58:50 +00:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2018-03-13 12:51:44 +00:00
|
|
|
return apiRequest();
|
2016-05-26 12:08:26 +00:00
|
|
|
},
|
|
|
|
|
|
2017-01-02 18:40:07 +00:00
|
|
|
/**
|
|
|
|
|
* Request the page HTML and various metadata from the MediaWiki API (which will use
|
|
|
|
|
* Parsoid or RESTBase).
|
|
|
|
|
*
|
2017-09-11 14:53:50 +00:00
|
|
|
* @param {string} pageName See #requestPageData
|
|
|
|
|
* @param {Object} [options] See #requestPageData
|
2019-10-14 19:49:02 +00:00
|
|
|
* @param {boolean} [noRestbase=false] Don't query RESTBase directly
|
2019-12-02 17:20:09 +00:00
|
|
|
* @param {boolean} [noMetadata=false] Don't fetch document metadata when querying RESTBase. Metadata
|
|
|
|
|
* is not required for some use cases, e.g. diffing.
|
2017-01-02 18:40:07 +00:00
|
|
|
* @return {jQuery.Promise} Abortable promise resolved with a JSON object
|
|
|
|
|
*/
|
2019-12-02 17:20:09 +00:00
|
|
|
requestParsoidData: function ( pageName, options, noRestbase, noMetadata ) {
|
2024-05-21 16:40:36 +00:00
|
|
|
const section = options.section !== undefined ? options.section : null,
|
|
|
|
|
useRestbase = !noRestbase && ( conf.fullRestbaseUrl || conf.restbaseUrl ) && section === null;
|
2015-03-13 15:50:23 +00:00
|
|
|
|
2017-09-11 14:53:50 +00:00
|
|
|
options = options || {};
|
2024-05-21 14:22:56 +00:00
|
|
|
const data = {
|
2018-05-20 10:53:19 +00:00
|
|
|
action: 'visualeditor',
|
2019-04-05 13:51:14 +00:00
|
|
|
paction: useRestbase ? 'metadata' : 'parse',
|
2018-05-20 10:53:19 +00:00
|
|
|
page: pageName,
|
2019-10-14 19:49:02 +00:00
|
|
|
badetag: options.badetag,
|
2018-05-20 10:53:19 +00:00
|
|
|
uselang: mw.config.get( 'wgUserLanguage' ),
|
2020-12-03 23:16:19 +00:00
|
|
|
editintro: options.editintro,
|
2018-05-20 10:53:19 +00:00
|
|
|
preload: options.preload,
|
2019-04-30 18:30:50 +00:00
|
|
|
preloadparams: options.preloadparams,
|
|
|
|
|
formatversion: 2
|
2018-05-20 10:53:19 +00:00
|
|
|
};
|
2017-09-11 14:53:50 +00:00
|
|
|
|
2015-03-13 15:50:23 +00:00
|
|
|
// Only request the API to explicitly load the currently visible revision if we're restoring
|
|
|
|
|
// from oldid. Otherwise we should load the latest version. This prevents us from editing an
|
|
|
|
|
// old version if an edit was made while the user was viewing the page and/or the user is
|
|
|
|
|
// seeing (slightly) stale cache.
|
2017-09-11 14:53:50 +00:00
|
|
|
if ( options.oldId !== undefined ) {
|
|
|
|
|
data.oldid = options.oldId;
|
2015-03-13 15:50:23 +00:00
|
|
|
}
|
|
|
|
|
// Load DOM
|
2024-05-21 14:22:56 +00:00
|
|
|
const start = ve.now();
|
2017-12-07 11:14:00 +00:00
|
|
|
ve.track( 'trace.apiLoad.enter', { mode: 'visual' } );
|
2015-03-13 15:50:23 +00:00
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
let apiXhr, apiPromise;
|
2024-05-21 16:40:36 +00:00
|
|
|
let switched = false,
|
|
|
|
|
fromEditedState = false;
|
2019-04-05 13:51:14 +00:00
|
|
|
if ( !useRestbase && options.wikitext !== undefined ) {
|
2017-10-11 20:26:18 +00:00
|
|
|
// Non-RESTBase custom wikitext parse
|
2019-05-13 18:37:11 +00:00
|
|
|
data.paction = 'parse';
|
|
|
|
|
data.stash = true;
|
|
|
|
|
switched = true;
|
|
|
|
|
fromEditedState = options.modified;
|
2017-10-11 20:26:18 +00:00
|
|
|
data.wikitext = options.wikitext;
|
2019-04-05 13:51:14 +00:00
|
|
|
data.section = options.section;
|
|
|
|
|
data.oldid = options.oldId;
|
2017-10-11 20:26:18 +00:00
|
|
|
apiXhr = new mw.Api().post( data );
|
|
|
|
|
} else {
|
2020-01-29 19:14:16 +00:00
|
|
|
if ( useRestbase && noMetadata ) {
|
2019-12-02 17:20:09 +00:00
|
|
|
apiPromise = $.Deferred().resolve( { visualeditor: {} } ).promise();
|
|
|
|
|
} else {
|
|
|
|
|
apiXhr = new mw.Api().get( data );
|
|
|
|
|
}
|
2017-10-11 20:26:18 +00:00
|
|
|
}
|
2019-12-02 17:20:09 +00:00
|
|
|
if ( !apiPromise ) {
|
2024-04-30 16:44:25 +00:00
|
|
|
apiPromise = apiXhr.then( ( response ) => {
|
2019-12-02 17:20:09 +00:00
|
|
|
ve.track( 'trace.apiLoad.exit', { mode: 'visual' } );
|
2023-03-17 23:52:06 +00:00
|
|
|
mw.track( 'timing.ve.' + options.targetName + '.performance.system.apiLoad',
|
|
|
|
|
ve.now() - start );
|
2020-08-18 12:16:49 +00:00
|
|
|
if ( response.visualeditor ) {
|
|
|
|
|
response.visualeditor.switched = switched;
|
|
|
|
|
response.visualeditor.fromEditedState = fromEditedState;
|
2019-12-02 17:20:09 +00:00
|
|
|
}
|
2020-08-18 12:16:49 +00:00
|
|
|
return response;
|
2015-03-13 15:50:23 +00:00
|
|
|
} );
|
2019-12-02 17:20:09 +00:00
|
|
|
}
|
2015-03-13 22:15:17 +00:00
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
let dataPromise, abort;
|
2019-04-05 13:51:14 +00:00
|
|
|
if ( useRestbase ) {
|
2017-12-07 11:14:00 +00:00
|
|
|
ve.track( 'trace.restbaseLoad.enter', { mode: 'visual' } );
|
2016-10-27 15:54:46 +00:00
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
const headers = {
|
2022-09-04 09:00:14 +00:00
|
|
|
// Should be synchronised with DirectParsoidClient.php
|
2023-05-26 18:29:28 +00:00
|
|
|
Accept: 'text/html; charset=utf-8; profile="https://www.mediawiki.org/wiki/Specs/HTML/2.8.0"',
|
2018-06-26 15:14:09 +00:00
|
|
|
'Accept-Language': mw.config.get( 'wgVisualEditor' ).pageLanguageCode,
|
2016-10-27 15:54:46 +00:00
|
|
|
'Api-User-Agent': 'VisualEditor-MediaWiki/' + mw.config.get( 'wgVersion' )
|
|
|
|
|
};
|
|
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
let restbaseXhr, pageHtmlUrl;
|
2017-09-11 14:53:50 +00:00
|
|
|
// Convert specified Wikitext to HTML
|
2016-04-11 22:34:00 +00:00
|
|
|
if (
|
2017-01-02 18:40:07 +00:00
|
|
|
// wikitext can be an empty string
|
2017-09-11 14:53:50 +00:00
|
|
|
options.wikitext !== undefined &&
|
2019-02-20 20:23:43 +00:00
|
|
|
// eslint-disable-next-line no-jquery/no-global-selector
|
2016-04-11 22:34:00 +00:00
|
|
|
!$( '[name=wpSection]' ).val()
|
|
|
|
|
) {
|
2017-03-09 17:30:16 +00:00
|
|
|
if ( conf.fullRestbaseUrl ) {
|
|
|
|
|
pageHtmlUrl = conf.fullRestbaseUrl + 'v1/transform/wikitext/to/html/';
|
|
|
|
|
} else {
|
|
|
|
|
pageHtmlUrl = conf.restbaseUrl.replace( 'v1/page/html/', 'v1/transform/wikitext/to/html/' );
|
|
|
|
|
}
|
2016-04-04 16:31:39 +00:00
|
|
|
switched = true;
|
2017-09-11 14:53:50 +00:00
|
|
|
fromEditedState = options.modified;
|
2015-11-07 03:57:19 +00:00
|
|
|
window.onbeforeunload = null;
|
|
|
|
|
$( window ).off( 'beforeunload' );
|
2016-02-27 01:58:13 +00:00
|
|
|
restbaseXhr = $.ajax( {
|
2017-03-09 17:30:16 +00:00
|
|
|
url: pageHtmlUrl + encodeURIComponent( pageName ) +
|
2017-09-11 14:53:50 +00:00
|
|
|
( data.oldid === undefined ? '' : '/' + data.oldid ),
|
2016-02-27 01:58:13 +00:00
|
|
|
type: 'POST',
|
|
|
|
|
data: {
|
2015-10-08 22:16:56 +00:00
|
|
|
title: pageName,
|
2017-09-11 14:53:50 +00:00
|
|
|
wikitext: options.wikitext,
|
2015-10-08 22:16:56 +00:00
|
|
|
stash: 'true'
|
2016-02-27 01:58:13 +00:00
|
|
|
},
|
2016-10-27 15:54:46 +00:00
|
|
|
headers: headers,
|
2016-02-27 01:58:13 +00:00
|
|
|
dataType: 'text'
|
|
|
|
|
} );
|
2015-10-08 22:16:56 +00:00
|
|
|
} else {
|
2017-09-11 14:53:50 +00:00
|
|
|
// Fetch revision
|
2015-10-08 22:16:56 +00:00
|
|
|
if ( conf.fullRestbaseUrl ) {
|
|
|
|
|
pageHtmlUrl = conf.fullRestbaseUrl + 'v1/page/html/';
|
|
|
|
|
} else {
|
|
|
|
|
pageHtmlUrl = conf.restbaseUrl;
|
|
|
|
|
}
|
|
|
|
|
restbaseXhr = $.ajax( {
|
|
|
|
|
url: pageHtmlUrl + encodeURIComponent( pageName ) +
|
2019-05-07 08:58:27 +00:00
|
|
|
( data.oldid === undefined ? '' : '/' + data.oldid ) +
|
|
|
|
|
'?redirect=false&stash=true',
|
2015-10-08 22:16:56 +00:00
|
|
|
type: 'GET',
|
2016-10-27 15:54:46 +00:00
|
|
|
headers: headers,
|
2015-10-08 22:16:56 +00:00
|
|
|
dataType: 'text'
|
|
|
|
|
} );
|
|
|
|
|
}
|
2024-05-21 14:22:56 +00:00
|
|
|
const restbasePromise = restbaseXhr.then(
|
2024-04-30 16:44:25 +00:00
|
|
|
( response, status, jqxhr ) => {
|
2017-12-07 11:14:00 +00:00
|
|
|
ve.track( 'trace.restbaseLoad.exit', { mode: 'visual' } );
|
2023-03-17 23:52:06 +00:00
|
|
|
mw.track( 'timing.ve.' + options.targetName + '.performance.system.restbaseLoad',
|
|
|
|
|
ve.now() - start );
|
2020-08-18 12:16:49 +00:00
|
|
|
return [ response, jqxhr.getResponseHeader( 'etag' ) ];
|
2015-03-30 02:44:06 +00:00
|
|
|
},
|
2024-04-30 16:44:25 +00:00
|
|
|
( xhr, code, _ ) => {
|
2016-12-21 03:19:19 +00:00
|
|
|
if ( xhr.status === 404 ) {
|
2015-03-30 02:44:06 +00:00
|
|
|
// Page does not exist, so let the user start with a blank document.
|
2015-11-04 15:31:19 +00:00
|
|
|
return $.Deferred().resolve( [ '', undefined ] ).promise();
|
2015-03-30 02:44:06 +00:00
|
|
|
} else {
|
2016-12-21 03:19:19 +00:00
|
|
|
mw.log.warn( 'RESTBase load failed: ' + xhr.statusText );
|
|
|
|
|
return $.Deferred().reject( code, xhr, _ ).promise();
|
2015-03-30 02:44:06 +00:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
);
|
2015-03-13 22:15:17 +00:00
|
|
|
|
|
|
|
|
dataPromise = $.when( apiPromise, restbasePromise )
|
2024-04-30 16:44:25 +00:00
|
|
|
.then( ( apiData, restbaseData ) => {
|
2015-03-13 22:15:17 +00:00
|
|
|
if ( apiData.visualeditor ) {
|
2017-09-14 20:08:09 +00:00
|
|
|
if ( restbaseData[ 0 ] || !apiData.visualeditor.content ) {
|
|
|
|
|
// If we have actual content loaded, use it.
|
|
|
|
|
// Otherwise, allow fallback content if present.
|
|
|
|
|
// If no fallback content, this will give us an empty string for
|
|
|
|
|
// content, which is desirable.
|
|
|
|
|
apiData.visualeditor.content = restbaseData[ 0 ];
|
|
|
|
|
apiData.visualeditor.etag = restbaseData[ 1 ];
|
|
|
|
|
}
|
2016-04-04 16:31:39 +00:00
|
|
|
apiData.visualeditor.switched = switched;
|
2015-10-08 22:16:56 +00:00
|
|
|
apiData.visualeditor.fromEditedState = fromEditedState;
|
2015-03-13 22:15:17 +00:00
|
|
|
}
|
|
|
|
|
return apiData;
|
2019-12-03 00:39:05 +00:00
|
|
|
} );
|
|
|
|
|
abort = function () {
|
2019-12-16 09:53:57 +00:00
|
|
|
if ( apiXhr ) {
|
|
|
|
|
apiXhr.abort();
|
|
|
|
|
}
|
2019-12-03 00:39:05 +00:00
|
|
|
restbaseXhr.abort();
|
|
|
|
|
};
|
2015-03-13 22:15:17 +00:00
|
|
|
} else {
|
2019-12-03 00:39:05 +00:00
|
|
|
dataPromise = apiPromise;
|
2019-12-16 09:53:57 +00:00
|
|
|
if ( apiXhr ) {
|
|
|
|
|
abort = apiXhr.abort;
|
|
|
|
|
}
|
2015-03-13 22:15:17 +00:00
|
|
|
}
|
|
|
|
|
|
2024-04-30 16:44:25 +00:00
|
|
|
return dataPromise.then( ( resp ) => {
|
2019-10-14 19:49:02 +00:00
|
|
|
// Adapted from RESTBase mwUtil.parseETag()
|
2024-05-21 14:22:56 +00:00
|
|
|
const etagRegexp = /^(?:W\/)?"?([^"/]+)(?:\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}))(?:\/([^"]+))?"?$/;
|
2019-10-14 19:49:02 +00:00
|
|
|
|
2019-10-21 19:21:15 +00:00
|
|
|
// `etag` is expected to be undefined when creating a new page.
|
|
|
|
|
// We can detect that case by `content` being empty, and not retry.
|
|
|
|
|
if ( useRestbase && resp.visualeditor.content && (
|
2019-10-14 19:49:02 +00:00
|
|
|
!resp.visualeditor.etag ||
|
2022-01-13 11:10:02 +00:00
|
|
|
!etagRegexp.test( resp.visualeditor.etag )
|
2019-10-14 19:49:02 +00:00
|
|
|
) ) {
|
|
|
|
|
// Direct request to RESTBase returned a mangled or missing etag.
|
|
|
|
|
// Retry via the MediaWiki API.
|
|
|
|
|
return mw.libs.ve.targetLoader.requestParsoidData(
|
|
|
|
|
pageName,
|
|
|
|
|
$.extend( {}, options, { badetag: resp.visualeditor.etag || '' } ),
|
|
|
|
|
true
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
2019-04-10 18:34:26 +00:00
|
|
|
resp.veMode = 'visual';
|
|
|
|
|
return resp;
|
2019-12-03 00:39:05 +00:00
|
|
|
} ).promise( { abort: abort } );
|
2016-05-26 12:08:26 +00:00
|
|
|
},
|
|
|
|
|
|
2017-01-02 18:40:07 +00:00
|
|
|
/**
|
|
|
|
|
* Request the page wikitext and various metadata from the MediaWiki API.
|
|
|
|
|
*
|
2017-09-11 14:53:50 +00:00
|
|
|
* @param {string} pageName See #requestPageData
|
|
|
|
|
* @param {Object} [options] See #requestPageData
|
2017-01-02 18:40:07 +00:00
|
|
|
* @return {jQuery.Promise} Abortable promise resolved with a JSON object
|
|
|
|
|
*/
|
2017-09-11 14:53:50 +00:00
|
|
|
requestWikitext: function ( pageName, options ) {
|
2018-05-20 10:53:19 +00:00
|
|
|
options = options || {};
|
2024-05-21 14:22:56 +00:00
|
|
|
const data = {
|
2016-10-28 00:22:30 +00:00
|
|
|
action: 'visualeditor',
|
|
|
|
|
paction: 'wikitext',
|
|
|
|
|
page: pageName,
|
2016-12-31 17:02:33 +00:00
|
|
|
uselang: mw.config.get( 'wgUserLanguage' ),
|
2020-12-03 23:16:19 +00:00
|
|
|
editintro: options.editintro,
|
2017-09-14 20:08:09 +00:00
|
|
|
preload: options.preload,
|
2019-04-30 18:30:50 +00:00
|
|
|
preloadparams: options.preloadparams,
|
|
|
|
|
formatversion: 2
|
2016-10-28 00:22:30 +00:00
|
|
|
};
|
2016-05-26 12:08:26 +00:00
|
|
|
|
2016-09-06 19:16:55 +00:00
|
|
|
// section should never really be undefined, but check just in case
|
2017-09-11 14:53:50 +00:00
|
|
|
if ( options.section !== null && options.section !== undefined ) {
|
|
|
|
|
data.section = options.section;
|
2016-09-06 19:16:55 +00:00
|
|
|
}
|
|
|
|
|
|
2017-09-11 14:53:50 +00:00
|
|
|
if ( options.oldId !== undefined ) {
|
|
|
|
|
data.oldid = options.oldId;
|
2016-05-26 12:08:26 +00:00
|
|
|
}
|
|
|
|
|
|
2024-05-21 14:22:56 +00:00
|
|
|
const dataPromise = new mw.Api().get( data );
|
2024-04-30 16:44:25 +00:00
|
|
|
return dataPromise.then( ( resp ) => {
|
2019-04-10 18:34:26 +00:00
|
|
|
resp.veMode = 'source';
|
|
|
|
|
return resp;
|
2019-12-03 00:39:05 +00:00
|
|
|
} ).promise( { abort: dataPromise.abort } );
|
Load RL modules in one load.php request, rather than in two stages
This introduces TargetLoader, which manages plugins and RL modules
in a slightly more generic fashion so that Targets themselves don't
have to. This allows us to load all RL modules in one load.php
request, rather than first loading ViewPageTarget which then
loads the other modules.
TargetLoader loads in the bottom queue, so it will be loaded
as part of the main load.php request, but in VPT.init.js we
still have to wait for it with using() because it might not
have arrived yet. This also degrades gracefully on cached pages
where TargetLoader isn't in the bottom queue: it'll be loaded
as a separate request instead, which is suboptimal but no
worse that what we were doing before.
Right now TargetLoader is small enough that it could also be in
the top queue, but in the future we want to add things like
the action=visualeditor API request to it, and mw.Api is
relatively big.
Note: this also makes a breaking change to the plugin API:
plugin callbacks no longer receive the target instance
as a parameter, as they're now executed before the target
has been constructed rather than after. In the long term,
if we want to give plugins access to the target instance,
we could give them the target promise somehow. For now,
I've killed this feature because nothing used it and
the change from a direct object reference to a promise
would have been a breaking change anyway.
Also fixed incorrect documentation index for ve.init.mw.ViewPageTarget.init.
Bug: T53569
Change-Id: Ibfa6abbeaf872ae2aadc6ed9d5beba7473ea441a
2015-02-26 01:22:44 +00:00
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
}() );
|