Adds a bootstrap function for easier startup of wmeSdk, WazeWrap, and ScriptUpdateMonitor.
此腳本不應該直接安裝，它是一個供其他腳本使用的函式庫。欲使用本函式庫，請在腳本 metadata 寫上： // @require https://update.gf.qytechs.cn/scripts/509664/1461898/WME%20Utils%20-%20Bootstrap.js
// ==UserScript==
// @name WME Utils - Bootstrap
// @namespace WazeDev
// @version 2024.10.09.000
// @description Adds a bootstrap function for easier startup of wmeSdk, WazeWrap, and ScriptUpdateMonitor.
// @author MapOMatic, WazeDev group
// @include /^https:\/\/(www|beta)\.waze\.com\/(?!user\/)(.{2,6}\/)?editor\/?.*$/
// @license GNU GPLv3
// ==/UserScript==
/* global WazeWrap */
/* global getWmeSdk */
/* global SDK_INITIALIZED */
// Using var here to allow scripts to override with their own bootstrap, if needed,
// without having to remove the @require line for this code.
// eslint-disable-next-line no-unused-vars, func-names, no-var
var bootstrap = (function() {
'use strict';
let wmeSdk;
function wmeReady(scriptName, scriptId) {
wmeSdk = getWmeSdk({ scriptName, scriptId });
return new Promise(resolve => {
if (wmeSdk.State.isReady()) resolve();
wmeSdk.Events.once({ eventName: 'wme-ready' }).then(resolve);
});
}
function wazeWrapReady(scriptName) {
return new Promise(resolve => {
(function checkWazeWrapReady(tries = 0) {
if (WazeWrap.Ready) {
resolve();
} else if (tries < 1000) {
setTimeout(checkWazeWrapReady, 200, ++tries);
} else {
console.error(`${scriptName}: WazeWrap took too long to load.`);
}
})();
});
}
function loadScriptUpdateMonitor(args) {
let updateMonitor;
try {
if (typeof GM_xmlhttpRequest === 'undefined') {
throw new Error('GM_xmlhttpRequest is required to use WazeWrap.Alerts.ScriptUpdateMonitor');
}
updateMonitor = new WazeWrap.Alerts.ScriptUpdateMonitor(
args.scriptName,
args.scriptUpdateMonitor.scriptVersion,
args.scriptUpdateMonitor.downloadUrl,
GM_xmlhttpRequest,
args.scriptUpdateMonitor.metaUrl,
args.scriptUpdateMonitor.metaRegExp
);
updateMonitor.start();
} catch (ex) {
// Report, but don't stop if ScriptUpdateMonitor fails.
console.error(`${args.scriptName}:`, ex);
}
}
async function bootstrapFunc(args) {
args = { ...args };
args.scriptName ??= GM_info.script.name;
args.scriptId ??= GM_info.script.name.replaceAll(' ', '');
await SDK_INITIALIZED;
await wmeReady(args.scriptName, args.scriptId);
if (args.useWazeWrap || args.scriptUpdateMonitor) await wazeWrapReady(args);
if (args.scriptUpdateMonitor) {
args.scriptUpdateMonitor.scriptVersion ??= GM_info.script.version;
loadScriptUpdateMonitor(args);
}
args.callback?.(wmeSdk);
return wmeSdk;
}
return bootstrapFunc;
})();