如何导入和使用 Javascript MediaWiki API？

Question

这看起来很基础，但没有可用的示例，并且文档以非常典型的方式很糟糕。他们没有说如何导入库。

我正在尝试使用 Typescript/React 项目中的 MediaWiki 官方支持的库。

文档中有一些基本用法的示例，但没有 import 语句。

我已经尝试过：

import mw from 'mediawiki'
console.log(mw)

这给了我一个包含非常意外的对象：

Object { version: "0.0.11", Bot: Bot(config) } 所以我尝试添加这个，匹配一些文档的样子：

const api = new mw.Bot() 这会产生一个我无法识别的对象，并且无法与现有文档一起使用。

这是怎么回事？我只想要一个库，它可以让我从 MediaWiki 站点获取所有类别以及给定类别中的所有页面。是我的问题还是这些文档完全错误且不完整？

或者也许我错过了所有 Javascript 开发人员都假设的非常简单的东西？我是一名职业软件开发人员，但我必须承认我用 Javascript 编程的次数比以前少了很多，所以这里可能缺少一些假设。

Answer 1

TL;DR：

您在没有先检查包描述

的情况下运行了

npm install mediawiki。

您链接的文档对应于 MediaWiki 前端通过

mw

公开的

mediawiki.api/index.js

对象。我个人并不知道这个文件可以通过 npm

 安装。

mediawiki

 上的 

npm

 包与您链接的文档不对应。它的最后一次发布是在 10 年前，不是由 Wikimedia（MediaWiki 的主要维护者）发布的，而是由 GitHub 用户

@oliver-moran 发布的。它还暴露了您在屏幕截图中显示的 mw.Bot

 API，这证实了我上面的怀疑。

如果您致力于使用已经尝试使用的客户端库，并且您还愿意手动维护它及其依赖项（包括 jQuery），那么您可能希望在项目中使用

mediawiki.api/index.js

的依赖项）。然而，我并不完全清楚这是否打算以这种方式使用或根本在 MediaWiki 前端执行上下文之外使用。

话虽这么说，MediaWiki 本身在其开发人员 wiki 上指出了

可在您的项目中使用的几个 JavaScript API 客户端库。