2 // mw.Title relies on these three config vars
3 // Restore them after each test run
5 wgFormattedNamespaces
: {
24 // testing custom / localized namespace
28 /*jshint camelcase: false */
51 /* testing custom / alias */
53 antarctic_waterfowl
: 100
55 wgCaseSensitiveNamespaces
: []
57 repeat = function ( input
, multiplier
) {
58 return new Array( multiplier
+ 1 ).join( input
);
61 // See also TitleTest.php#testSecureAndSplit
73 'File_talk:Example.svg',
77 // Length is 256 total, but only title part matters
78 'Category:' + repeat( 'x', 248 ),
86 // Bad characters forbidden regardless of wgLegalTitleChars
98 // XML/HTML character entity references
99 // Note: The ones with # are commented out as those are interpreted as fragment and
100 // as such end up being valid.
104 // Subject of NS_TALK does not roundtrip to NS_MAIN
105 'Talk:File:Example.svg',
106 // Directory navigation
120 // Extension separation is a js invention, for length
121 // purposes it is part of the title
122 repeat( 'x', 252 ) + '.json',
123 // Namespace prefix without actual title
131 QUnit
.module( 'mediawiki.Title', QUnit
.newMwEnvironment( { config
: config
} ) );
133 QUnit
.test( 'constructor', cases
.invalid
.length
, function ( assert
) {
135 for ( i
= 0; i
< cases
.valid
.length
; i
++ ) {
136 title
= new mw
.Title( cases
.valid
[i
] );
138 for ( i
= 0; i
< cases
.invalid
.length
; i
++ ) {
139 /*jshint loopfunc:true */
140 title
= cases
.invalid
[i
];
141 assert
.throws( function () {
142 return new mw
.Title( title
);
143 }, cases
.invalid
[i
] );
147 QUnit
.test( 'newFromText', cases
.valid
.length
+ cases
.invalid
.length
, function ( assert
) {
149 for ( i
= 0; i
< cases
.valid
.length
; i
++ ) {
151 $.type( mw
.Title
.newFromText( cases
.valid
[i
] ) ),
156 for ( i
= 0; i
< cases
.invalid
.length
; i
++ ) {
158 $.type( mw
.Title
.newFromText( cases
.invalid
[i
] ) ),
165 QUnit
.test( 'Basic parsing', 12, function ( assert
) {
167 title
= new mw
.Title( 'File:Foo_bar.JPG' );
169 assert
.equal( title
.getNamespaceId(), 6 );
170 assert
.equal( title
.getNamespacePrefix(), 'File:' );
171 assert
.equal( title
.getName(), 'Foo_bar' );
172 assert
.equal( title
.getNameText(), 'Foo bar' );
173 assert
.equal( title
.getExtension(), 'JPG' );
174 assert
.equal( title
.getDotExtension(), '.JPG' );
175 assert
.equal( title
.getMain(), 'Foo_bar.JPG' );
176 assert
.equal( title
.getMainText(), 'Foo bar.JPG' );
177 assert
.equal( title
.getPrefixedDb(), 'File:Foo_bar.JPG' );
178 assert
.equal( title
.getPrefixedText(), 'File:Foo bar.JPG' );
180 title
= new mw
.Title( 'Foo#bar' );
181 assert
.equal( title
.getPrefixedText(), 'Foo' );
182 assert
.equal( title
.getFragment(), 'bar' );
185 QUnit
.test( 'Transformation', 11, function ( assert
) {
188 title
= new mw
.Title( 'File:quux pif.jpg' );
189 assert
.equal( title
.getNameText(), 'Quux pif', 'First character of title' );
191 title
= new mw
.Title( 'File:Glarg_foo_glang.jpg' );
192 assert
.equal( title
.getNameText(), 'Glarg foo glang', 'Underscores' );
194 title
= new mw
.Title( 'User:ABC.DEF' );
195 assert
.equal( title
.toText(), 'User:ABC.DEF', 'Round trip text' );
196 assert
.equal( title
.getNamespaceId(), 2, 'Parse canonical namespace prefix' );
198 title
= new mw
.Title( 'Image:quux pix.jpg' );
199 assert
.equal( title
.getNamespacePrefix(), 'File:', 'Transform alias to canonical namespace' );
201 title
= new mw
.Title( 'uSEr:hAshAr' );
202 assert
.equal( title
.toText(), 'User:HAshAr' );
203 assert
.equal( title
.getNamespaceId(), 2, 'Case-insensitive namespace prefix' );
205 // Don't ask why, it's the way the backend works. One space is kept of each set.
206 title
= new mw
.Title( 'Foo __ \t __ bar' );
207 assert
.equal( title
.getMain(), 'Foo_bar', 'Merge multiple types of whitespace/underscores into a single underscore' );
209 // Regression test: Previously it would only detect an extension if there is no space after it
210 title
= new mw
.Title( 'Example.js ' );
211 assert
.equal( title
.getExtension(), 'js', 'Space after an extension is stripped' );
213 title
= new mw
.Title( 'Example#foo' );
214 assert
.equal( title
.getFragment(), 'foo', 'Fragment' );
216 title
= new mw
.Title( 'Example#_foo_bar baz_' );
217 assert
.equal( title
.getFragment(), ' foo bar baz', 'Fragment' );
220 QUnit
.test( 'Namespace detection and conversion', 10, function ( assert
) {
223 title
= new mw
.Title( 'File:User:Example' );
224 assert
.equal( title
.getNamespaceId(), 6, 'Titles can contain namespace prefixes, which are otherwise ignored' );
226 title
= new mw
.Title( 'Example', 6 );
227 assert
.equal( title
.getNamespaceId(), 6, 'Default namespace passed is used' );
229 title
= new mw
.Title( 'User:Example', 6 );
230 assert
.equal( title
.getNamespaceId(), 2, 'Included namespace prefix overrides the given default' );
232 title
= new mw
.Title( ':Example', 6 );
233 assert
.equal( title
.getNamespaceId(), 0, 'Colon forces main namespace' );
235 title
= new mw
.Title( 'something.PDF', 6 );
236 assert
.equal( title
.toString(), 'File:Something.PDF' );
238 title
= new mw
.Title( 'NeilK', 3 );
239 assert
.equal( title
.toString(), 'User_talk:NeilK' );
240 assert
.equal( title
.toText(), 'User talk:NeilK' );
242 title
= new mw
.Title( 'Frobisher', 100 );
243 assert
.equal( title
.toString(), 'Penguins:Frobisher' );
245 title
= new mw
.Title( 'antarctic_waterfowl:flightless_yet_cute.jpg' );
246 assert
.equal( title
.toString(), 'Penguins:Flightless_yet_cute.jpg' );
248 title
= new mw
.Title( 'Penguins:flightless_yet_cute.jpg' );
249 assert
.equal( title
.toString(), 'Penguins:Flightless_yet_cute.jpg' );
252 QUnit
.test( 'Throw error on invalid title', 1, function ( assert
) {
253 assert
.throws( function () {
254 return new mw
.Title( '' );
255 }, 'Throw error on empty string' );
258 QUnit
.test( 'Case-sensivity', 3, function ( assert
) {
262 mw
.config
.set( 'wgCaseSensitiveNamespaces', [] );
264 title
= new mw
.Title( 'article' );
265 assert
.equal( title
.toString(), 'Article', 'Default config: No sensitive namespaces by default. First-letter becomes uppercase' );
267 // $wgCapitalLinks = false;
268 mw
.config
.set( 'wgCaseSensitiveNamespaces', [0, -2, 1, 4, 5, 6, 7, 10, 11, 12, 13, 14, 15] );
270 title
= new mw
.Title( 'article' );
271 assert
.equal( title
.toString(), 'article', '$wgCapitalLinks=false: Article namespace is sensitive, first-letter case stays lowercase' );
273 title
= new mw
.Title( 'john', 2 );
274 assert
.equal( title
.toString(), 'User:John', '$wgCapitalLinks=false: User namespace is insensitive, first-letter becomes uppercase' );
277 QUnit
.test( 'toString / toText', 2, function ( assert
) {
278 var title
= new mw
.Title( 'Some random page' );
280 assert
.equal( title
.toString(), title
.getPrefixedDb() );
281 assert
.equal( title
.toText(), title
.getPrefixedText() );
284 QUnit
.test( 'getExtension', 7, function ( assert
) {
285 function extTest( pagename
, ext
, description
) {
286 var title
= new mw
.Title( pagename
);
287 assert
.equal( title
.getExtension(), ext
, description
|| pagename
);
290 extTest( 'MediaWiki:Vector.js', 'js' );
291 extTest( 'User:Example/common.css', 'css' );
292 extTest( 'File:Example.longextension', 'longextension', 'Extension parsing not limited (bug 36151)' );
293 extTest( 'Example/information.json', 'json', 'Extension parsing not restricted from any namespace' );
294 extTest( 'Foo.', null, 'Trailing dot is not an extension' );
295 extTest( 'Foo..', null, 'Trailing dots are not an extension' );
296 extTest( 'Foo.a.', null, 'Page name with dots and ending in a dot does not have an extension' );
298 // @broken: Throws an exception
299 // extTest( '.NET', null, 'Leading dot is (or is not?) an extension' );
302 QUnit
.test( 'exists', 3, function ( assert
) {
305 // Empty registry, checks default to null
307 title
= new mw
.Title( 'Some random page', 4 );
308 assert
.strictEqual( title
.exists(), null, 'Return null with empty existance registry' );
310 // Basic registry, checks default to boolean
311 mw
.Title
.exist
.set( ['Does_exist', 'User_talk:NeilK', 'Wikipedia:Sandbox_rules'], true );
312 mw
.Title
.exist
.set( ['Does_not_exist', 'User:John', 'Foobar'], false );
314 title
= new mw
.Title( 'Project:Sandbox rules' );
315 assert
.assertTrue( title
.exists(), 'Return true for page titles marked as existing' );
316 title
= new mw
.Title( 'Foobar' );
317 assert
.assertFalse( title
.exists(), 'Return false for page titles marked as nonexistent' );
321 QUnit
.test( 'getUrl', 3, function ( assert
) {
325 mw
.config
.set( 'wgArticlePath', '/wiki/$1' );
327 title
= new mw
.Title( 'Foobar' );
328 assert
.equal( title
.getUrl(), '/wiki/Foobar', 'Basic functionality, getUrl uses mw.util.getUrl' );
329 assert
.equal( title
.getUrl({ action
: 'edit' }), '/wiki/Foobar?action=edit', 'Basic functionality, \'params\' parameter' );
331 title
= new mw
.Title( 'John Doe', 3 );
332 assert
.equal( title
.getUrl(), '/wiki/User_talk:John_Doe', 'Escaping in title and namespace for urls' );
335 QUnit
.test( 'newFromImg', 40, function ( assert
) {
336 var title
, i
, thisCase
, prefix
,
339 url
: '//upload.wikimedia.org/wikipedia/commons/thumb/b/bf/Princess_Alexandra_of_Denmark_%28later_Queen_Alexandra%2C_wife_of_Edward_VII%29_with_her_two_eldest_sons%2C_Prince_Albert_Victor_%28Eddy%29_and_George_Frederick_Ernest_Albert_%28later_George_V%29.jpg/939px-thumbnail.jpg',
340 typeOfUrl
: 'Hashed thumb with shortened path',
341 nameText
: 'Princess Alexandra of Denmark (later Queen Alexandra, wife of Edward VII) with her two eldest sons, Prince Albert Victor (Eddy) and George Frederick Ernest Albert (later George V)',
342 prefixedText
: 'File:Princess Alexandra of Denmark (later Queen Alexandra, wife of Edward VII) with her two eldest sons, Prince Albert Victor (Eddy) and George Frederick Ernest Albert (later George V).jpg'
345 url
: '/wiki/images/thumb/9/91/Anticlockwise_heliotrope%27s.jpg/99px-Anticlockwise_heliotrope%27s.jpg',
346 typeOfUrl
: 'Normal hashed directory thumbnail',
347 nameText
: 'Anticlockwise heliotrope\'s',
348 prefixedText
: 'File:Anticlockwise heliotrope\'s.jpg'
352 url
: '/wiki/images/thumb/8/80/Wikipedia-logo-v2.svg/langde-150px-Wikipedia-logo-v2.svg.png',
353 typeOfUrl
: 'Normal hashed directory thumbnail with complex thumbnail parameters',
354 nameText
: 'Wikipedia-logo-v2',
355 prefixedText
: 'File:Wikipedia-logo-v2.svg'
359 url
: '//upload.wikimedia.org/wikipedia/commons/thumb/8/80/Wikipedia-logo-v2.svg/150px-Wikipedia-logo-v2.svg.png',
360 typeOfUrl
: 'Commons thumbnail',
361 nameText
: 'Wikipedia-logo-v2',
362 prefixedText
: 'File:Wikipedia-logo-v2.svg'
366 url
: '/wiki/images/9/91/Anticlockwise_heliotrope%27s.jpg',
367 typeOfUrl
: 'Full image',
368 nameText
: 'Anticlockwise heliotrope\'s',
369 prefixedText
: 'File:Anticlockwise heliotrope\'s.jpg'
373 url
: 'http://localhost/thumb.php?f=Stuffless_Figaro%27s.jpg&width=180',
374 typeOfUrl
: 'thumb.php-based thumbnail',
375 nameText
: 'Stuffless Figaro\'s',
376 prefixedText
: 'File:Stuffless Figaro\'s.jpg'
380 url
: '/wikipedia/commons/thumb/Wikipedia-logo-v2.svg/150px-Wikipedia-logo-v2.svg.png',
381 typeOfUrl
: 'Commons unhashed thumbnail',
382 nameText
: 'Wikipedia-logo-v2',
383 prefixedText
: 'File:Wikipedia-logo-v2.svg'
387 url
: '/wikipedia/commons/thumb/Wikipedia-logo-v2.svg/langde-150px-Wikipedia-logo-v2.svg.png',
388 typeOfUrl
: 'Commons unhashed thumbnail with complex thumbnail parameters',
389 nameText
: 'Wikipedia-logo-v2',
390 prefixedText
: 'File:Wikipedia-logo-v2.svg'
394 url
: '/wiki/images/Anticlockwise_heliotrope%27s.jpg',
395 typeOfUrl
: 'Unhashed local file',
396 nameText
: 'Anticlockwise heliotrope\'s',
397 prefixedText
: 'File:Anticlockwise heliotrope\'s.jpg'
402 typeOfUrl
: 'Empty string'
407 typeOfUrl
: 'String with only alphabet characters'
411 url
: 'foobar.foobar',
412 typeOfUrl
: 'Not a file path'
416 url
: '/a/a0/blah blah blah',
417 typeOfUrl
: 'Space characters'
421 for ( i
= 0; i
< cases
.length
; i
++ ) {
423 title
= mw
.Title
.newFromImg( { src
: thisCase
.url
} );
425 if ( thisCase
.nameText
!== undefined ) {
426 prefix
= '[' + thisCase
.typeOfUrl
+ ' URL' + '] ';
428 assert
.notStrictEqual( title
, null, prefix
+ 'Parses successfully' );
429 assert
.equal( title
.getNameText(), thisCase
.nameText
, prefix
+ 'Filename matches original' );
430 assert
.equal( title
.getPrefixedText(), thisCase
.prefixedText
, prefix
+ 'File page title matches original' );
431 assert
.equal( title
.getNamespaceId(), 6, prefix
+ 'Namespace ID matches File namespace' );
433 assert
.strictEqual( title
, null, thisCase
.typeOfUrl
+ ', should not produce an mw.Title object' );
438 }( mediaWiki
, jQuery
) );