wikiparser-node 0.3.0 → 0.4.0

package/src/transclude.js

@@ -2,7 +2,7 @@
 
 const {removeComment, escapeRegExp, text, noWrap} = require('../util/string'),
 	{externalUse} = require('../util/debug'),
-	/** @type {Parser} */ Parser = require('..'),
+	Parser = require('..'),
 	Token = require('.'),
 	ParameterToken = require('./parameter');
 
@@ -16,12 +16,16 @@ class TranscludeToken extends Token {
 	/** @type {Set<string>} */ #keys = new Set();
 	/** @type {Record<string, Set<ParameterToken>>} */ #args = {};
 
-	/** @complexity `n` */
+	/**
+	 * 设置引用修饰符
+	 * @param {string} modifier 引用修饰符
+	 * @complexity `n`
+	 */
 	setModifier(modifier = '') {
 		if (typeof modifier !== 'string') {
 			this.typeError('setModifier', 'String');
 		}
-		const [,, raw, subst] = this.getAttribute('config').parserFunction,
+		const {parserFunction: [,, raw, subst]} = this.getAttribute('config'),
 			lcModifier = modifier.trim().toLowerCase(),
 			isRaw = raw.includes(lcModifier),
 			isSubst = subst.includes(lcModifier),
@@ -36,16 +40,17 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {string} title
-	 * @param {[string, string|undefined][]} parts
+	 * @param {string} title 模板标题或魔术字
+	 * @param {[string, string|undefined][]} parts 参数各部分
 	 * @param {accum} accum
 	 * @complexity `n`
+	 * @throws `SyntaxError` 非法的模板名称
 	 */
 	constructor(title, parts, config = Parser.getConfig(), accum = []) {
 		super(undefined, config, true, accum, {AtomToken: 0, SyntaxToken: 0, ParameterToken: '1:'});
 		const AtomToken = require('./atom'),
-			SyntaxToken = require('./syntax'),
-			{parserFunction: [insensitive, sensitive, raw]} = config;
+			SyntaxToken = require('./syntax');
+		const {parserFunction: [insensitive, sensitive, raw]} = config;
 		this.seal('modifier');
 		if (title.includes(':')) {
 			const [modifier, ...arg] = title.split(':');
@@ -58,13 +63,13 @@ class TranscludeToken extends Token {
 				name = removeComment(magicWord),
 				isSensitive = sensitive.includes(name);
 			if (isSensitive || insensitive.includes(name.toLowerCase())) {
-				this.setAttribute('name', name.toLowerCase().replace(/^#/, '')).type = 'magic-word';
+				this.setAttribute('name', name.toLowerCase().replace(/^#/u, '')).type = 'magic-word';
 				const pattern = new RegExp(`^\\s*${name}\\s*$`, isSensitive ? '' : 'i'),
 					token = new SyntaxToken(magicWord, pattern, 'magic-word-name', config, accum, {
 						'Stage-1': ':', '!ExtToken': '',
 					});
 				this.appendChild(token);
-				if (arg.length) {
+				if (arg.length > 0) {
 					parts.unshift([arg.join(':')]);
 				}
 				if (this.name === 'invoke') {
@@ -79,13 +84,13 @@ class TranscludeToken extends Token {
 						}`, config, accum, {'Stage-1': ':', '!ExtToken': ''});
 						this.appendChild(invoke);
 					}
-					this.protectChildren('1:3');
+					this.getAttribute('protectChildren')('1:3');
 				}
 			}
 		}
 		if (this.type === 'template') {
 			const [name] = removeComment(title).split('#');
-			if (/\x00\d+[eh!+-]\x7f|[<>[\]{}]/.test(name)) {
+			if (/\0\d+[eh!+-]\x7F|[<>[\]{}]/u.test(name)) {
 				accum.pop();
 				throw new SyntaxError(`非法的模板名称：${name}`);
 			}
@@ -106,11 +111,12 @@ class TranscludeToken extends Token {
 			}
 			this.appendChild(new ParameterToken(...part, config, accum));
 		}
-		this.protectChildren(0);
+		this.getAttribute('protectChildren')(0);
 	}
 
+	/** @override */
 	cloneNode() {
-		const [first, ...cloned] = this.cloneChildren(),
+		const [first, ...cloned] = this.cloneChildNodes(),
 			config = this.getAttribute('config');
 		return Parser.run(() => {
 			const token = new TranscludeToken(this.type === 'template' ? '' : first.text(), [], config);
@@ -122,12 +128,12 @@ class TranscludeToken extends Token {
 		});
 	}
 
+	/** @override */
 	afterBuild() {
-		if (this.name.includes('\x00')) {
-			this.setAttribute('name', text(this.buildFromStr(this.name)));
+		if (this.name.includes('\0')) {
+			this.setAttribute('name', text(this.getAttribute('buildFromStr')(this.name)));
 		}
 		if (this.matches('template, magic-word#invoke')) {
-			const that = this;
 			/**
 			 * 当事件bubble到`parameter`时，将`oldKey`和`newKey`保存进AstEventData。
 			 * 当继续bubble到`template`时，处理并删除`oldKey`和`newKey`。
@@ -140,15 +146,15 @@ class TranscludeToken extends Token {
 					delete data.oldKey;
 					delete data.newKey;
 				}
-				if (prevTarget === that.firstElementChild && that.type === 'template') {
-					that.setAttribute('name', that.normalizeTitle(prevTarget.text(), 10).title);
+				if (prevTarget === this.firstElementChild && this.type === 'template') {
+					this.setAttribute('name', this.normalizeTitle(prevTarget.text(), 10).title);
 				} else if (oldKey !== newKey && prevTarget instanceof ParameterToken) {
-					const oldArgs = that.getArgs(oldKey, false, false);
+					const oldArgs = this.getArgs(oldKey, false, false);
 					oldArgs.delete(prevTarget);
-					that.getArgs(newKey, false, false).add(prevTarget);
-					that.#keys.add(newKey);
+					this.getArgs(newKey, false, false).add(prevTarget);
+					this.#keys.add(newKey);
 					if (oldArgs.size === 0) {
-						that.#keys.delete(oldKey);
+						this.#keys.delete(oldKey);
 					}
 				}
 			};
@@ -157,17 +163,20 @@ class TranscludeToken extends Token {
 		return this;
 	}
 
+	/** 替换引用 */
 	subst() {
 		this.setModifier('subst');
 	}
 
+	/** 安全的替换引用 */
 	safesubst() {
 		this.setModifier('safesubst');
 	}
 
 	/**
+	 * @override
 	 * @template {string} T
-	 * @param {T} key
+	 * @param {T} key 属性键
 	 * @returns {TokenAttribute<T>}
 	 */
 	getAttribute(key) {
@@ -179,30 +188,40 @@ class TranscludeToken extends Token {
 		return super.getAttribute(key);
 	}
 
-	toString() {
-		const {children, childNodes: {length}, firstChild} = this;
-		return `{{${this.modifier}${this.modifier && ':'}${
+	/**
+	 * @override
+	 * @param {string} selector
+	 */
+	toString(selector) {
+		if (selector && this.matches(selector)) {
+			return '';
+		}
+		const {children, childNodes: {length}, firstChild, modifier} = this;
+		return `{{${modifier}${modifier && ':'}${
 			this.type === 'magic-word'
 				? `${String(firstChild)}${length > 1 ? ':' : ''}${children.slice(1).map(String).join('|')}`
-				: super.toString('|')
+				: super.toString(selector, '|')
 		}}}`;
 	}
 
+	/** @override */
 	getPadding() {
 		return this.modifier ? this.modifier.length + 3 : 2;
 	}
 
+	/** @override */
 	getGaps() {
 		return 1;
 	}
 
 	/**
+	 * @override
 	 * @returns {string}
 	 * @complexity `n`
 	 */
 	text() {
-		const {children, childNodes: {length}, firstElementChild} = this;
-		return `{{${this.modifier}${this.modifier && ':'}${
+		const {children, childNodes: {length}, firstElementChild, modifier} = this;
+		return `{{${modifier}${modifier && ':'}${
 			this.type === 'magic-word'
 				? `${firstElementChild.text()}${length > 1 ? ':' : ''}${text(children.slice(1), '|')}`
 				: super.text('|')
@@ -210,7 +229,8 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {number|ParameterToken} addedToken
+	 * 处理匿名参数更改
+	 * @param {number|ParameterToken} addedToken 新增的参数
 	 * @complexity `n`
 	 */
 	#handleAnonArgChange(addedToken) {
@@ -223,8 +243,9 @@ class TranscludeToken extends Token {
 			this.#keys.delete(maxAnon);
 		}
 		const j = added ? args.indexOf(addedToken) : addedToken - 1;
-		for (const [i, token] of [...args.entries()].slice(j)) {
-			const {name} = token,
+		for (let i = j; i < args.length; i++) {
+			const token = args[i],
+				{name} = token,
 				newName = String(i + 1);
 			if (name !== newName) {
 				this.getArgs(newName, false, false).add(token.setAttribute('name', newName));
@@ -236,7 +257,8 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {number} i
+	 * @override
+	 * @param {number} i 移除位置
 	 * @complexity `n`
 	 */
 	removeAt(i) {
@@ -254,7 +276,9 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {ParameterToken} token
+	 * @override
+	 * @param {ParameterToken} token 待插入的子节点
+	 * @param {number} i 插入位置
 	 * @complexity `n`
 	 */
 	insertAt(token, i = this.childNodes.length) {
@@ -269,6 +293,7 @@ class TranscludeToken extends Token {
 	}
 
 	/**
+	 * 获取所有参数
 	 * @returns {ParameterToken[]}
 	 * @complexity `n`
 	 */
@@ -276,21 +301,26 @@ class TranscludeToken extends Token {
 		return this.children.filter(child => child instanceof ParameterToken);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取匿名参数
+	 * @complexity `n`
+	 */
 	getAnonArgs() {
 		return this.getAllArgs().filter(({anon}) => anon);
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 获取指定参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
+	 * @param {boolean} copy 是否返回一个备份
 	 * @complexity `n`
 	 */
-	getArgs(key, exact = false, copy = true) {
-		if (!['string', 'number'].includes(typeof key)) {
+	getArgs(key, exact, copy = true) {
+		if (typeof key !== 'string' && typeof key !== 'number') {
 			this.typeError('getArgs', 'String', 'Number');
-		} else if (!copy && !Parser.debugging && externalUse('getArgs')) {
-			this.debugOnly('getArgs');
 		}
+		copy ||= !Parser.debugging && externalUse('getArgs');
 		const keyStr = String(key).trim();
 		let args = this.#args[keyStr];
 		if (!args) {
@@ -306,26 +336,32 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 是否具有某参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
 	 * @complexity `n`
 	 */
-	hasArg(key, exact = false) {
+	hasArg(key, exact) {
 		return this.getArgs(key, exact, false).size > 0;
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 获取生效的指定参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
 	 * @complexity `n`
 	 */
-	getArg(key, exact = false) {
-		return [...this.getArgs(key, exact, false)].sort((a, b) => a.comparePosition(b)).at(-1);
+	getArg(key, exact) {
+		return [...this.getArgs(key, exact, false)].sort((a, b) => a.compareDocumentPosition(b)).at(-1);
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 移除指定参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
 	 * @complexity `n`
 	 */
-	removeArg(key, exact = false) {
+	removeArg(key, exact) {
 		Parser.run(() => {
 			for (const token of this.getArgs(key, exact, false)) {
 				this.removeChild(token);
@@ -333,10 +369,13 @@ class TranscludeToken extends Token {
 		});
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取所有参数名
+	 * @complexity `n`
+	 */
 	getKeys() {
 		const args = this.getAllArgs();
-		if (this.#keys.size === 0 && args.length) {
+		if (this.#keys.size === 0 && args.length > 0) {
 			for (const {name} of args) {
 				this.#keys.add(name);
 			}
@@ -345,7 +384,8 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 获取参数值
+	 * @param {string|number} key 参数名
 	 * @complexity `n`
 	 */
 	getValues(key) {
@@ -353,22 +393,24 @@ class TranscludeToken extends Token {
 	}
 
 	/**
+	 * 获取生效的参数值
 	 * @template {string|number|undefined} T
-	 * @param {T} key
+	 * @param {T} key 参数名
 	 * @returns {T extends undefined ? Object<string, string> : string}
 	 * @complexity `n`
 	 */
 	getValue(key) {
-		if (key !== undefined) {
-			return this.getArg(key)?.getValue();
-		}
-		return Object.fromEntries(this.getKeys().map(k => [k, this.getValue(k)]));
+		return key === undefined
+			? Object.fromEntries(this.getKeys().map(k => [k, this.getValue(k)]))
+			: this.getArg(key)?.getValue();
 	}
 
 	/**
-	 * @param {string} val
+	 * 插入匿名参数
+	 * @param {string} val 参数值
 	 * @returns {ParameterToken}
 	 * @complexity `n`
+	 * @throws `SyntaxError` 非法的匿名参数
 	 */
 	newAnonArg(val) {
 		val = String(val);
@@ -376,18 +418,21 @@ class TranscludeToken extends Token {
 			wikitext = `{{${templateLike ? ':T|' : 'lc:'}${val}}}`,
 			root = Parser.parse(wikitext, this.getAttribute('include'), 2, this.getAttribute('config')),
 			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || !firstElementChild?.matches(templateLike ? 'template#T' : 'magic-word#lc')
-			|| firstElementChild.childNodes.length !== 2 || !firstElementChild.lastElementChild.anon
+		if (length === 1 && firstElementChild?.matches(templateLike ? 'template#T' : 'magic-word#lc')
+			&& firstElementChild.childNodes.length === 2 && firstElementChild.lastElementChild.anon
 		) {
-			throw new SyntaxError(`非法的匿名参数：${noWrap(val)}`);
+			return this.appendChild(firstElementChild.lastChild);
 		}
-		return this.appendChild(firstElementChild.lastChild);
+		throw new SyntaxError(`非法的匿名参数：${noWrap(val)}`);
 	}
 
 	/**
-	 * @param {string} key
-	 * @param {string} value
+	 * 设置参数值
+	 * @param {string} key 参数名
+	 * @param {string} value 参数值
 	 * @complexity `n`
+	 * @throws `Error` 仅用于模板
+	 * @throws `SyntaxError` 非法的命名参数
 	 */
 	setValue(key, value) {
 		if (typeof key !== 'string') {
@@ -412,18 +457,26 @@ class TranscludeToken extends Token {
 		this.appendChild(firstElementChild.lastChild);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 将匿名参数改写为命名参数
+	 * @complexity `n`
+	 * @throws `Error` 仅用于模板
+	 */
 	anonToNamed() {
 		if (!this.matches('template, magic-word#invoke')) {
 			throw new Error(`${this.constructor.name}.anonToNamed 方法仅供模板使用！`);
 		}
 		for (const token of this.getAnonArgs()) {
-			token.anon = false;
 			token.firstElementChild.replaceChildren(token.name);
 		}
 	}
 
-	/** @param {string} title */
+	/**
+	 * 替换模板名
+	 * @param {string} title 模板名
+	 * @throws `Error` 仅用于模板
+	 * @throws `SyntaxError` 非法的模板名称
+	 */
 	replaceTemplate(title) {
 		if (this.type === 'magic-word') {
 			throw new Error(`${this.constructor.name}.replaceTemplate 方法仅用于更换模板！`);
@@ -438,7 +491,12 @@ class TranscludeToken extends Token {
 		this.firstElementChild.replaceChildren(...firstElementChild.firstElementChild.childNodes);
 	}
 
-	/** @param {string} title */
+	/**
+	 * 替换模块名
+	 * @param {string} title 模块名
+	 * @throws `Error` 仅用于模块
+	 * @throws `SyntaxError` 非法的模块名称
+	 */
 	replaceModule(title) {
 		if (this.type !== 'magic-word' || this.name !== 'invoke') {
 			throw new Error(`${this.constructor.name}.replaceModule 方法仅用于更换模块！`);
@@ -455,13 +513,18 @@ class TranscludeToken extends Token {
 			this.children[1].replaceChildren(...firstElementChild.lastElementChild.childNodes);
 		} else {
 			const {lastChild} = firstElementChild;
-			root.destroy();
-			firstElementChild.destroy();
+			firstElementChild.destroy(true);
 			this.appendChild(lastChild);
 		}
 	}
 
-	/** @param {string} func */
+	/**
+	 * 替换模块函数
+	 * @param {string} func 模块函数名
+	 * @throws `Error` 仅用于模块
+	 * @throws `Error` 尚未指定模块名称
+	 * @throws `SyntaxError` 非法的模块函数名
+	 */
 	replaceFunction(func) {
 		if (this.type !== 'magic-word' || this.name !== 'invoke') {
 			throw new Error(`${this.constructor.name}.replaceModule 方法仅用于更换模块！`);
@@ -470,7 +533,9 @@ class TranscludeToken extends Token {
 		} else if (this.childNodes.length < 2) {
 			throw new Error('尚未指定模块名称！');
 		}
-		const root = Parser.parse(`{{#invoke:M|${func}}}`, this.getAttribute('include'), 2, this.getAttribute('config')),
+		const root = Parser.parse(
+				`{{#invoke:M|${func}}}`, this.getAttribute('include'), 2, this.getAttribute('config'),
+			),
 			{childNodes: {length}, firstElementChild} = root;
 		if (length !== 1 || !firstElementChild?.matches('magic-word#invoke')
 			|| firstElementChild.childNodes.length !== 3
@@ -480,39 +545,48 @@ class TranscludeToken extends Token {
 			this.children[2].replaceChildren(...firstElementChild.lastElementChild.childNodes);
 		} else {
 			const {lastChild} = firstElementChild;
-			root.destroy();
-			firstElementChild.destroy();
+			firstElementChild.destroy(true);
 			this.appendChild(lastChild);
 		}
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 是否存在重名参数
+	 * @complexity `n`
+	 * @throws `Error` 仅用于模板
+	 */
 	hasDuplicatedArgs() {
-		if (!this.matches('template, magic-word#invoke')) {
-			throw new Error(`${this.constructor.name}.hasDuplicatedArgs 方法仅供模板使用！`);
+		if (this.matches('template, magic-word#invoke')) {
+			return this.getAllArgs().length - this.getKeys().length;
 		}
-		return this.getAllArgs().length - this.getKeys().length;
+		throw new Error(`${this.constructor.name}.hasDuplicatedArgs 方法仅供模板使用！`);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取重名参数
+	 * @complexity `n`
+	 * @throws `Error` 仅用于模板
+	 */
 	getDuplicatedArgs() {
-		if (!this.matches('template, magic-word#invoke')) {
-			throw new Error(`${this.constructor.name}.getDuplicatedArgs 方法仅供模板使用！`);
+		if (this.matches('template, magic-word#invoke')) {
+			return Object.entries(this.#args).filter(([, {size}]) => size > 1).map(([key, args]) => [key, new Set(args)]);
 		}
-		return Object.entries(this.#args).filter(([, {size}]) => size > 1).map(([key, args]) => [key, new Set(args)]);
+		throw new Error(`${this.constructor.name}.getDuplicatedArgs 方法仅供模板使用！`);
 	}
 
 	/**
+	 * 修复重名参数：
 	 * `aggressive = false`时只移除空参数和全同参数，优先保留匿名参数，否则将所有匿名参数更改为命名。
-	 * `aggressive = true`时还会尝试处理连续的以数字编号的参数
+	 * `aggressive = true`时还会尝试处理连续的以数字编号的参数。
+	 * @param {boolean} aggressive 是否使用有更大风险的修复手段
 	 * @complexity `n²`
 	 */
-	fixDuplication(aggressive = false) {
+	fixDuplication(aggressive) {
 		if (!this.hasDuplicatedArgs()) {
 			return [];
 		}
 		const /** @type {string[]} */ duplicatedKeys = [];
-		let anonCount = this.getAnonArgs().length;
+		let {length: anonCount} = this.getAnonArgs();
 		for (const [key, args] of this.getDuplicatedArgs()) {
 			if (args.size <= 1) {
 				continue;
@@ -551,10 +625,10 @@ class TranscludeToken extends Token {
 			let remaining = args.size - badArgs.length;
 			if (remaining === 1) {
 				continue;
-			} else if (aggressive && (anonCount ? /\D\d+$/ : /(?:^|\D)\d+$/).test(key)) {
+			} else if (aggressive && (anonCount ? /\D\d+$/u : /(?:^|\D)\d+$/u).test(key)) {
 				let /** @type {number} */ last;
-				const str = key.slice(0, -key.match(/\d+$/)[0].length),
-					regex = new RegExp(`^${escapeRegExp(str)}\\d+$`),
+				const str = key.slice(0, -/(?<!\d)\d+$/u.exec(key)[0].length),
+					regex = new RegExp(`^${escapeRegExp(str)}\\d+$`, 'u'),
 					series = this.getAllArgs().filter(({name}) => regex.test(name)),
 					ordered = series.every(({name}, i) => {
 						const j = Number(name.slice(str.length)),
@@ -563,8 +637,9 @@ class TranscludeToken extends Token {
 						return cmp;
 					});
 				if (ordered) {
-					for (const [i, arg] of series.entries()) {
-						const name = `${str}${i + 1}`;
+					for (let i = 0; i < series.length; i++) {
+						const name = `${str}${i + 1}`,
+							arg = series[i];
 						if (arg.name !== name) {
 							if (arg.name === key) {
 								remaining--;
@@ -590,25 +665,27 @@ class TranscludeToken extends Token {
 	}
 
 	/**
+	 * 转义模板内的表格
 	 * @returns {TranscludeToken}
 	 * @complexity `n`
+	 * @throws `Error` 转义失败
 	 */
 	escapeTables() {
 		const count = this.hasDuplicatedArgs();
-		if (!/\n\s*:*\s*{\|.*\n\s*\|}/s.test(this.text()) || !count) {
+		if (!/\n[^\S\n]*(?::+\s*)?\{\|[^\n]*\n\s*(?:\S[^\n]*\n\s*)*\|\}/u.test(this.text()) || !count) {
 			return this;
 		}
-		const stripped = this.toString().slice(2, -2),
+		const stripped = String(this).slice(2, -2),
 			include = this.getAttribute('include'),
 			config = this.getAttribute('config'),
-			parsed = Parser.parse(stripped, include, 4, config),
-			TableToken = require('./table');
+			parsed = Parser.parse(stripped, include, 4, config);
+		const TableToken = require('./table');
 		for (const table of parsed.children) {
 			if (table instanceof TableToken) {
 				table.escape();
 			}
 		}
-		const {firstChild, childNodes} = Parser.parse(`{{${parsed.toString()}}}`, include, 2, config);
+		const {firstChild, childNodes} = Parser.parse(`{{${String(parsed)}}}`, include, 2, config);
 		if (childNodes.length !== 1 || !(firstChild instanceof TranscludeToken)) {
 			throw new Error('转义表格失败！');
 		}

package/test/api.js

@@ -0,0 +1,83 @@
+/** @file 为MediaWiki API请求提供Promise界面 */
+'use strict';
+const request = require('request'),
+	{sleep} = require('./util'),
+	{info} = require('..');
+
+/**
+ * 规范化API请求参数
+ * @param {Record<string, string|number|boolean|(string|number)[]>} obj 请求参数
+ * @returns {Record<string, string}
+ * @throws `TypeError` 部分参数不是字符串或数字
+ */
+const normalizeValues = obj => {
+	for (const [key, val] of Object.entries(obj)) {
+		if (val === undefined || val === false) {
+			delete obj[key];
+		} else if (val === true) {
+			obj[key] = 1;
+		} else if (Array.isArray(val)) {
+			obj[key] = val.join('|');
+		} else if (typeof val !== 'string' && typeof val !== 'number') {
+			throw new TypeError('API请求的各项参数均为字符串或数字！');
+		}
+	}
+	return obj;
+};
+
+/** 通用MediaWiki站点的请求 */
+class Api {
+	url;
+	request = request.defaults({jar: true});
+
+	/**
+	 * @param {string} url 网址
+	 * @throws `RangeError` 无效网址
+	 */
+	constructor(url) {
+		try {
+			new URL(url);
+		} catch {
+			throw new RangeError('不是有效的网址！');
+		}
+		this.url = url;
+	}
+
+	/**
+	 * GET请求
+	 * @param {Record<string, string|number|boolean|(string|number)[]>} params 请求参数
+	 * @returns {Promise<any>}
+	 */
+	async get(params) {
+		params = normalizeValues(params);
+		const /** @type {Record<string, string|number>} */ qs = {
+			action: 'query', format: 'json', formatversion: 2, errorformat: 'plaintext', ...params,
+		};
+		try {
+			return await new Promise((resolve, reject) => {
+				this.request.get({url: this.url, qs}, (e, response, body) => {
+					const statusCode = response?.statusCode;
+					if (e) {
+						reject({statusCode, ...e});
+					} else {
+						try {
+							const data = JSON.parse(body);
+							resolve(data);
+						} catch {
+							reject({statusCode, body});
+						}
+					}
+				});
+			});
+		} catch (e) {
+			if ([500, 502, 504].includes(e.statusCode)) {
+				info(`对网址 ${this.url} 发出的GET请求触发错误代码 ${e.statusCode}，30秒后将再次尝试。`);
+				await sleep(30);
+				return this.get(params);
+			}
+			throw e;
+		}
+	}
+}
+
+module.exports = Api;