summaryrefslogtreecommitdiff
path: root/resources/src/jquery/jquery.mwExtension.js
blob: 27ceb2bc45f4fa4f9a07315734d81d96e31b83a2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
/*
 * JavaScript backwards-compatibility alternatives and other convenience functions
 *
 * @deprecated since 1.26 Dated collection of miscellaneous utilities. Methods are
 *  either trivially inline, obsolete, or have a better place elsewhere.
 */
( function ( $, mw ) {
	$.each( {
		trimLeft: function ( str ) {
			return str === null ? '' : str.toString().replace( /^\s+/, '' );
		},
		trimRight: function ( str ) {
			return str === null ?
					'' : str.toString().replace( /\s+$/, '' );
		},
		ucFirst: function ( str ) {
			return str.charAt( 0 ).toUpperCase() + str.slice( 1 );
		},
		isDomElement: function ( el ) {
			return !!el && !!el.nodeType;
		},
		isEmpty: function ( v ) {
			var key;
			if (
				v === '' || v === 0 || v === '0' || v === null || v === false || v === undefined
			) {
				return true;
			}
			// the for-loop could potentially contain prototypes
			// to avoid that we check its length first
			if ( v.length === 0 ) {
				return true;
			}
			if ( typeof v === 'object' ) {
				for ( key in v ) {
					return false;
				}
				return true;
			}
			return false;
		},
		compareArray: function ( arrThis, arrAgainst ) {
			if ( arrThis.length !== arrAgainst.length ) {
				return false;
			}
			for ( var i = 0; i < arrThis.length; i++ ) {
				if ( $.isArray( arrThis[ i ] ) ) {
					if ( !$.compareArray( arrThis[ i ], arrAgainst[ i ] ) ) {
						return false;
					}
				} else if ( arrThis[ i ] !== arrAgainst[ i ] ) {
					return false;
				}
			}
			return true;
		},
		compareObject: function ( objectA, objectB ) {
			var prop, type;

			// Do a simple check if the types match
			if ( typeof objectA === typeof objectB ) {

				// Only loop over the contents if it really is an object
				if ( typeof objectA === 'object' ) {
					// If they are aliases of the same object (ie. mw and mediaWiki) return now
					if ( objectA === objectB ) {
						return true;
					} else {
						// Iterate over each property
						for ( prop in objectA ) {
							// Check if this property is also present in the other object
							if ( prop in objectB ) {
								// Compare the types of the properties
								type = typeof objectA[ prop ];
								if ( type === typeof objectB[ prop ] ) {
									// Recursively check objects inside this one
									switch ( type ) {
										case 'object' :
											if ( !$.compareObject( objectA[ prop ], objectB[ prop ] ) ) {
												return false;
											}
											break;
										case 'function' :
											// Functions need to be strings to compare them properly
											if ( objectA[ prop ].toString() !== objectB[ prop ].toString() ) {
												return false;
											}
											break;
										default:
											// Strings, numbers
											if ( objectA[ prop ] !== objectB[ prop ] ) {
												return false;
											}
											break;
									}
								} else {
									return false;
								}
							} else {
								return false;
							}
						}
						// Check for properties in B but not in A
						// This is about 15% faster (tested in Safari 5 and Firefox 3.6)
						// ...than incrementing a count variable in the above and below loops
						// See also: https://www.mediawiki.org/wiki/ResourceLoader/Default_modules/compareObject_test#Results
						for ( prop in objectB ) {
							if ( !( prop in objectA ) ) {
								return false;
							}
						}
					}
				}
			} else {
				return false;
			}
			return true;
		}
	}, function ( key, value ) {
		mw.log.deprecate( $, key, value );
	} );

	mw.log.deprecate( $, 'escapeRE', function ( str ) {
		return str.replace( /([\\{}()|.?*+\-\^$\[\]])/g, '\\$1' );
	}, 'Use mediawiki.RegExp instead.' );

} )( jQuery, mediaWiki );