selenium: Fix and update links in comments and documentation

Bug: T324766
Change-Id: If62835494fe7dd47fc4f18b881783570340cb5a9
This commit is contained in:
Željko Filipin 2024-02-15 14:46:21 +01:00
parent d0400faad1
commit 02b182d180
7 changed files with 23 additions and 24 deletions

View file

@ -2,15 +2,14 @@
## Getting started
See <https://www.mediawiki.org/wiki/Selenium/Node.js> for how to best
See <https://www.mediawiki.org/wiki/Selenium> for how to best
run these locally. Below the internal prerequisites are documented,
but you might not need to install these yourself.
## Prerequisites
- [Chromium](https://www.chromium.org/) or [Chrome](https://www.google.com/chrome/)
- [ChromeDriver](https://chromedriver.chromium.org/downloads)
- [Node.js](https://nodejs.org/en/)
- [Chromium](https://www.chromium.org/Home) or [Chrome](https://www.google.com/chrome)
- [Node.js](https://nodejs.org)
## Usage
@ -71,4 +70,4 @@ The following environment variables decide where to find MediaWiki and how to lo
## Further reading
- [Selenium/Node.js](https://www.mediawiki.org/wiki/Selenium/Node.js) on mediawiki.org
- [Selenium](https://www.mediawiki.org/wiki/Selenium) on mediawiki.org

View file

@ -4,7 +4,7 @@
1. Look for any outstanding bugs.
Especially (unreleased) regressions should be addressed before a release.
<https://phabricator.wikimedia.org/tag/mediawiki-core-testing/>
<https://phabricator.wikimedia.org/tag/mediawiki-core-tests>
2. Create or reset your `release` branch to the latest head of the repository
```

View file

@ -3,7 +3,7 @@
const querystring = require( 'querystring' );
/**
* Based on http://webdriver.io/guide/testrunner/pageobjects.html
* Based on https://webdriver.io/docs/pageobjects
*/
class Page {
@ -11,7 +11,7 @@ class Page {
* Navigate the browser to a given page.
*
* @since 1.0.0
* @see <http://webdriver.io/api/protocol/url.html>
* @see <https://webdriver.io/docs/api/browser/url>
* @param {string} title Page title
* @param {Object} [query] Query parameter
* @param {string} [fragment] Fragment parameter

View file

@ -1,12 +1,12 @@
# wdio-mediawiki
A plugin for [WebdriverIO](http://webdriver.io/) providing utilities to simplify testing of MediaWiki features.
A plugin for [WebdriverIO](https://webdriver.io) providing utilities to simplify testing of MediaWiki features.
## Getting Started
### Page
The `Page` class is a base class for following the [Page Objects Pattern](http://webdriver.io/guide/testrunner/pageobjects.html).
The `Page` class is a base class for following the [Page Objects Pattern](https://webdriver.io/docs/pageobjects).
* `openTitle( title [, Object query [, string fragment ] ] )`
@ -17,7 +17,7 @@ See [BlankPage](./BlankPage.js) and [specs/BlankPage](./specs/BlankPage.js) for
### Api
Utilities to interact with the MediaWiki API. Uses the [mwbot](https://github.com/Fannon/mwbot) library.
Utilities to interact with the MediaWiki API. Uses the [mwbot](https://github.com/gesinn-it-pub/mwbot) library.
Actions are performed logged-in using `browser.config.mwUser` and `browser.config.mwPwd`,
which typically come from `MEDIAWIKI_USER` and `MEDIAWIKI_PASSWORD` environment variables.
@ -50,7 +50,7 @@ making assertions that depend on its outcome.
## Versioning
This package follows [Semantic Versioning guidelines](https://semver.org/) for its releases. In
This package follows [Semantic Versioning guidelines](https://semver.org) for its releases. In
particular, its major version must be bumped when compatibility is removed for a previous of
MediaWiki.
@ -65,11 +65,11 @@ co-exists with its deprecated equivalent for at least one release.
## Issue tracker
Please report issues to [Phabricator](https://phabricator.wikimedia.org/tag/mediawiki-core-tests/).
Please report issues to [Phabricator](https://phabricator.wikimedia.org/tag/mediawiki-core-tests).
## Contributing
This module is maintained in the MediaWiki core repository and published from there as a
package to npmjs.org. To simplify development and to ensure changes are verified
automatically, MediaWiki core itself uses this module directly from the working copy
using [npm Local Paths](https://docs.npmjs.com/files/package.json#local-paths).
using [npm Local Paths](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#local-paths).

View file

@ -2,7 +2,7 @@
"name": "wdio-mediawiki",
"version": "2.5.0",
"description": "WebdriverIO plugin for testing a MediaWiki site.",
"homepage": "https://gerrit.wikimedia.org/g/mediawiki/core/+/master/tests/selenium/wdio-mediawiki/",
"homepage": "https://gerrit.wikimedia.org/g/mediawiki/core/+/master/tests/selenium/wdio-mediawiki",
"license": "MIT",
"keywords": [
"mediawiki",

View file

@ -24,8 +24,8 @@ if ( !process.env.MW_SERVER || !process.env.MW_SCRIPT_PATH ) {
/**
* For more details documentation and available options:
* - https://webdriver.io/docs/configurationfile/
* - https://webdriver.io/docs/options/
* - https://webdriver.io/docs/configurationfile
* - https://webdriver.io/docs/configuration
*/
exports.config = {
// ======
@ -56,7 +56,7 @@ exports.config = {
maxInstances: 1,
capabilities: [ {
// For Chrome/Chromium https://sites.google.com/a/chromium.org/chromedriver/capabilities
// For Chrome/Chromium https://www.w3.org/TR/webdriver
browserName: 'chrome',
'goog:chromeOptions': {
// If DISPLAY is set, assume developer asked non-headless or CI with Xvfb.
@ -85,9 +85,9 @@ exports.config = {
bail: 0,
// Base for browser.url() and wdio-mediawiki/Page#openTitle()
baseUrl: process.env.MW_SERVER + process.env.MW_SCRIPT_PATH,
// See also: https://webdriver.io/docs/frameworks/
// See also: https://webdriver.io/docs/frameworks
framework: 'mocha',
// See also: https://mochajs.org/
// See also: https://mochajs.org
// The number of times to retry the entire specfile when it fails as a whole
specFileRetries: 1,
// Delay in seconds between the spec file retry attempts
@ -99,11 +99,11 @@ exports.config = {
ui: 'bdd',
timeout: process.env.DEBUG ? ( 60 * 60 * 1000 ) : ( 60 * 1000 )
},
// See also: https://webdriver.io/docs/dot-reporter.html
// See also: https://webdriver.io/docs/dot-reporter
reporters: [
// See also: https://webdriver.io/docs/spec-reporter/
// See also: https://webdriver.io/docs/spec-reporter
'spec',
// See also: https://webdriver.io/docs/junit-reporter/
// See also: https://webdriver.io/docs/junit-reporter
[ 'junit', {
outputDir: logPath,
outputFileFormat: function () {

View file

@ -5,7 +5,7 @@ const { config } = require( 'wdio-mediawiki/wdio-defaults.conf.js' );
exports.config = { ...config,
// Override, or add to, the setting from wdio-mediawiki.
// Learn more at https://webdriver.io/docs/configurationfile/
// Learn more at https://webdriver.io/docs/configurationfile
//
// Example:
// logLevel: 'info',