types-mediawiki
v1.9.1
Published
TypeScript definitions for MediaWiki JS interface
Downloads
1,924
Readme
types-mediawiki
TypeScript definitions for MediaWiki JS interface.
This package covers the functions and classes in the mw
global object, as well some jQuery plugins used in MediaWiki core. All commonly used parts of the interface are covered.
@types/jquery
and @types/oojs-ui
from DefinitelyTyped are included as dependencies, so you don't need to install them separately.
Usage
To use types from this package, run
npm i types-mediawiki
Edit your project's tsconfig.json
file so that it includes
"include": [
"./node_modules/types-mediawiki"
]
You should be all set! mw
will be available in the global scope. There is no need to put any import statements in the TypeScript source files.
If you find any errors or have suggestions for more specific typings, please open a PR or file an issue.
mw.config
Types for mw.config are included:
let NS = mw.config.get("wgNamespaceNumber"); // NS gets type number
let pageName = mw.config.get("wgPageName"); // pageName gets type string
mw.config entries added by MediaWiki extensions can also be used but their type is not known, so they need to be explicitly cast:
let namespaces = mw.config.get("pageTriageNamespaces") as number[];
(mw.config.get('pageTriageNamespaces')
gets the type unknown
without a cast.)
MediaWiki API parameters
This package also provides typings for API request parameters for the MediaWiki Action API. API endpoints defined in MediaWiki core and by a number of common extensions (the ones enabled on English Wikipedia) are covered. These aren't exported to the global scope, however. For usage, you need to import them. For example:
import type { ApiEditPageParams, ApiParseParams } from "types-mediawiki/api_params";
Since it is just a type import, it doesn't generate any JavaScript. Hence, such imports can also be used in non-modular applications.