From 37efdff89b5bff4eb22d5b235a0e1171faa39192 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartosz=20Dziewo=C5=84ski?= Date: Wed, 7 May 2025 19:52:03 +0200 Subject: [PATCH] Link mw.Uri migration guide in docs and log warnings Bug: T374314 Change-Id: Iefc350b5e8fd02cb46853bb90ef1e7c7ae7dd2cc (cherry picked from commit 1223f307a1f2d7d3637138d72605a8b5f87d91a8) --- resources/Resources.php | 3 ++- resources/src/mediawiki.Uri/Uri.js | 8 ++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/resources/Resources.php b/resources/Resources.php index 638e4da8a38..8fb9e660156 100644 --- a/resources/Resources.php +++ b/resources/Resources.php @@ -1166,7 +1166,8 @@ return [ ], ], 'dependencies' => 'mediawiki.util', - 'deprecated' => '[1.43] Please use browser native URL.', + 'deprecated' => + '[1.43] Please use browser native URL. See https://www.mediawiki.org/wiki/Migrating_mw.Uri_to_URL', ], 'mediawiki.user' => [ 'scripts' => 'resources/src/mediawiki.user.js', diff --git a/resources/src/mediawiki.Uri/Uri.js b/resources/src/mediawiki.Uri/Uri.js index 83bece52116..35da1893eb4 100644 --- a/resources/src/mediawiki.Uri/Uri.js +++ b/resources/src/mediawiki.Uri/Uri.js @@ -94,6 +94,10 @@ /** * @classdesc Create and manipulate MediaWiki URIs. * + * **DEPRECATED: mw.Uri has been deprecated in MediaWiki 1.43.** + * Please use the browser native {@link URL} class instead. + * See {@link https://www.mediawiki.org/wiki/Migrating_mw.Uri_to_URL migration guide}. + * * Intended to be minimal, but featureful; do not expect full RFC 3986 compliance. The use cases we * have in mind are constructing 'next page' or 'previous page' URLs, detecting whether we need to * use cross-domain proxies for an API, constructing simple URL-based API calls, etc. Parsing here @@ -140,6 +144,10 @@ * Parsing based on parseUri 1.2.2 (c) Steven Levithan , MIT License. * * + * @deprecated since MediaWiki 1.43. + * Please use the browser native {@link URL} class instead. + * See {@link https://www.mediawiki.org/wiki/Migrating_mw.Uri_to_URL migration guide}. + * * @class * @name mw.Uri *