mermaid

<!DOCTYPE html> <html> <head> <title>matchersUtil.js</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <link rel="stylesheet" media="all" href="../../../../../doc-style.css" /> <script src="../../../../../doc-filelist.js"></script> <script> var relativeDir = "../../../../../", thisFile = "Users/knut/Documents/source/mermaid/bower_components/jasmine/src/core/matchers/matchersUtil.js", defaultSidebar = true; </script> <script src="../../../../../doc-script.js"></script> <script src="../../../../../mermaid.js"></script> <link rel="stylesheet" href="../../../../../mermaid.css" /> </head> <body> <div id="sidebar_wrapper"> <div id="sidebar_switch"> Files Headings </div> <div id="tree"></div> <div id="headings"> <div class="heading h1"> <a href="#matchersUtil.js">matchersUtil.js</a> </div> </div> </div> <div id="sidebar-toggle"></div> <div id="container"><div class="background highlight"></div> <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td class="docs"> <div class="pilwrap" id="matchersUtil.js"> <h1> <a href="#matchersUtil.js" name="matchersUtil.js" class="pilcrow">¶</a>matchersUtil.js </h1> </div> </td> <td class="code highlight"></td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-1" id="section-1">¶</a> </div> </td> <td class="code highlight"><div class="highlight"><pre>getJasmineRequireObj().matchersUtil = function(j$) { </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-2" id="section-2">¶</a> </div> TODO: what to do about jasmine.pp not being inject? move to JSON.stringify? gut PrettyPrinter? </td> <td class="code highlight"><div class="highlight"><pre> return { equals: function(a, b, customTesters) { customTesters = customTesters || []; return eq(a, b, [], [], customTesters); }, contains: function(haystack, needle, customTesters) { customTesters = customTesters || []; if (Object.prototype.toString.apply(haystack) === '[object Array]') { for (var i = 0; i < haystack.length; i++) { if (eq(haystack[i], needle, [], [], customTesters)) { return true; } } return false; } return !!haystack && haystack.indexOf(needle) >= 0; }, buildFailureMessage: function() { var args = Array.prototype.slice.call(arguments, 0), matcherName = args[0], isNot = args[1], actual = args[2], expected = args.slice(3), englishyPredicate = matcherName.replace(/[A-Z]/g, function(s) { return ' ' + s.toLowerCase(); }); var message = 'Expected ' + j$.pp(actual) + (isNot ? ' not ' : ' ') + englishyPredicate; if (expected.length > 0) { for (var i = 0; i < expected.length; i++) { if (i > 0) { message += ','; } message += ' ' + j$.pp(expected[i]); } } return message + '.'; } }; </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-3" id="section-3">¶</a> </div> Equality function lovingly adapted from isEqual in <a href="http://underscorejs.org">Underscore</a> </td> <td class="code highlight"><div class="highlight"><pre> function eq(a, b, aStack, bStack, customTesters) { var result = true; for (var i = 0; i < customTesters.length; i++) { var customTesterResult = customTesters[i](a, b); if (!j$.util.isUndefined(customTesterResult)) { return customTesterResult; } } if (a instanceof j$.Any) { result = a.jasmineMatches(b); if (result) { return true; } } if (b instanceof j$.Any) { result = b.jasmineMatches(a); if (result) { return true; } } if (b instanceof j$.ObjectContaining) { result = b.jasmineMatches(a); if (result) { return true; } } if (a instanceof Error && b instanceof Error) { return a.message == b.message; } </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-4" id="section-4">¶</a> </div> Identical objects are equal. <code>0 === -0</code>, but they aren't identical. See the <a href="http://wiki.ecmascript.org/doku.php?id=harmony:egal">Harmony <code>egal</code> proposal</a>. </td> <td class="code highlight"><div class="highlight"><pre> if (a === b) { return a !== 0 || 1 / a == 1 / b; } </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-5" id="section-5">¶</a> </div> A strict comparison is necessary because <code>null == undefined</code>. </td> <td class="code highlight"><div class="highlight"><pre> if (a === null || b === null) { return a === b; } var className = Object.prototype.toString.call(a); if (className != Object.prototype.toString.call(b)) { return false; } switch (className) { </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-6" id="section-6">¶</a> </div> Strings, numbers, dates, and booleans are compared by value. </td> <td class="code highlight"><div class="highlight"><pre> case '[object String]': </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-7" id="section-7">¶</a> </div> Primitives and their corresponding object wrappers are equivalent; thus, <code>"5"</code> is equivalent to <code>new String("5")</code>. </td> <td class="code highlight"><div class="highlight"><pre> return a == String(b); case '[object Number]': </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-8" id="section-8">¶</a> </div> <code>NaN</code>s are equivalent, but non-reflexive. An <code>egal</code> comparison is performed for other numeric values. </td> <td class="code highlight"><div class="highlight"><pre> return a != +a ? b != +b : (a === 0 ? 1 / a == 1 / b : a == +b); case '[object Date]': case '[object Boolean]': </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-9" id="section-9">¶</a> </div> Coerce dates and booleans to numeric primitive values. Dates are compared by their millisecond representations. Note that invalid dates with millisecond representations of <code>NaN</code> are not equivalent. </td> <td class="code highlight"><div class="highlight"><pre> return +a == +b; </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-10" id="section-10">¶</a> </div> RegExps are compared by their source patterns and flags. </td> <td class="code highlight"><div class="highlight"><pre> case '[object RegExp]': return a.source == b.source && a.global == b.global && a.multiline == b.multiline && a.ignoreCase == b.ignoreCase; } if (typeof a != 'object' || typeof b != 'object') { return false; } </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-11" id="section-11">¶</a> </div> Assume equality for cyclic structures. The algorithm for detecting cyclic structures is adapted from ES 5.1 section 15.12.3, abstract operation <code>JO</code>. </td> <td class="code highlight"><div class="highlight"><pre> var length = aStack.length; while (length--) { </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-12" id="section-12">¶</a> </div> Linear search. Performance is inversely proportional to the number of unique nested structures. </td> <td class="code highlight"><div class="highlight"><pre> if (aStack[length] == a) { return bStack[length] == b; } } </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-13" id="section-13">¶</a> </div> Add the first object to the stack of traversed objects. </td> <td class="code highlight"><div class="highlight"><pre> aStack.push(a); bStack.push(b); var size = 0; </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-14" id="section-14">¶</a> </div> Recursively compare objects and arrays. </td> <td class="code highlight"><div class="highlight"><pre> if (className == '[object Array]') { </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-15" id="section-15">¶</a> </div> Compare array lengths to determine if a deep comparison is necessary. </td> <td class="code highlight"><div class="highlight"><pre> size = a.length; result = size == b.length; if (result) { </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-16" id="section-16">¶</a> </div> Deep compare the contents, ignoring non-numeric properties. </td> <td class="code highlight"><div class="highlight"><pre> while (size--) { if (!(result = eq(a[size], b[size], aStack, bStack, customTesters))) { break; } } } } else { </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-17" id="section-17">¶</a> </div> Objects with different constructors are not equivalent, but <code>Object</code>s from different frames are. </td> <td class="code highlight"><div class="highlight"><pre> var aCtor = a.constructor, bCtor = b.constructor; if (aCtor !== bCtor && !(isFunction(aCtor) && (aCtor instanceof aCtor) && isFunction(bCtor) && (bCtor instanceof bCtor))) { return false; } </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-18" id="section-18">¶</a> </div> Deep compare objects. </td> <td class="code highlight"><div class="highlight"><pre> for (var key in a) { if (has(a, key)) { </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-19" id="section-19">¶</a> </div> Count the expected number of properties. </td> <td class="code highlight"><div class="highlight"><pre> size++; </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-20" id="section-20">¶</a> </div> Deep compare each member. </td> <td class="code highlight"><div class="highlight"><pre> if (!(result = has(b, key) && eq(a[key], b[key], aStack, bStack, customTesters))) { break; } } } </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-21" id="section-21">¶</a> </div> Ensure that both objects contain the same number of properties. </td> <td class="code highlight"><div class="highlight"><pre> if (result) { for (key in b) { if (has(b, key) && !(size--)) { break; } } result = !size; } } </pre></div> </td> </tr> <tr> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-22" id="section-22">¶</a> </div> Remove the first object from the stack of traversed objects. </td> <td class="code highlight"><div class="highlight"><pre> aStack.pop(); bStack.pop(); return result; function has(obj, key) { return obj.hasOwnProperty(key); } function isFunction(obj) { return typeof obj === 'function'; } } }; </pre></div> </td> </tr> </tbody> </table> </div> </body> </html>