diff options
Diffstat (limited to 'contexts/data/lib/closure-library/closure/goog/testing/stacktrace.js')
| -rw-r--r-- | contexts/data/lib/closure-library/closure/goog/testing/stacktrace.js | 516 |
1 files changed, 0 insertions, 516 deletions
diff --git a/contexts/data/lib/closure-library/closure/goog/testing/stacktrace.js b/contexts/data/lib/closure-library/closure/goog/testing/stacktrace.js deleted file mode 100644 index 040108a..0000000 --- a/contexts/data/lib/closure-library/closure/goog/testing/stacktrace.js +++ /dev/null @@ -1,516 +0,0 @@ -// Copyright 2009 The Closure Library Authors. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS-IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. - -/** - * @fileoverview Tools for parsing and pretty printing error stack traces. - * - */ - -goog.provide('goog.testing.stacktrace'); -goog.provide('goog.testing.stacktrace.Frame'); - - - -/** - * Class representing one stack frame. - * @param {string} context Context object, empty in case of global functions or - * if the browser doesn't provide this information. - * @param {string} name Function name, empty in case of anonymous functions. - * @param {string} alias Alias of the function if available. For example the - * function name will be 'c' and the alias will be 'b' if the function is - * defined as <code>a.b = function c() {};</code>. - * @param {string} args Arguments of the function in parentheses if available. - * @param {string} path File path or URL including line number and optionally - * column number separated by colons. - * @constructor - */ -goog.testing.stacktrace.Frame = function(context, name, alias, args, path) { - this.context_ = context; - this.name_ = name; - this.alias_ = alias; - this.args_ = args; - this.path_ = path; -}; - - -/** - * @return {string} The function name or empty string if the function is - * anonymous and the object field which it's assigned to is unknown. - */ -goog.testing.stacktrace.Frame.prototype.getName = function() { - return this.name_; -}; - - -/** - * @return {boolean} Whether the stack frame contains an anonymous function. - */ -goog.testing.stacktrace.Frame.prototype.isAnonymous = function() { - return !this.name_ || this.context_ == '[object Object]'; -}; - - -/** - * Brings one frame of the stack trace into a common format across browsers. - * @return {string} Pretty printed stack frame. - */ -goog.testing.stacktrace.Frame.prototype.toCanonicalString = function() { - var htmlEscape = goog.testing.stacktrace.htmlEscape_; - var deobfuscate = goog.testing.stacktrace.maybeDeobfuscateFunctionName_; - - var canonical = [ - this.context_ ? htmlEscape(this.context_) + '.' : '', - this.name_ ? htmlEscape(deobfuscate(this.name_)) : 'anonymous', - htmlEscape(this.args_), - this.alias_ ? ' [as ' + htmlEscape(deobfuscate(this.alias_)) + ']' : '' - ]; - - if (this.path_) { - canonical.push(' at '); - // If Closure Inspector is installed and running, then convert the line - // into a source link for displaying the code in Firebug. - if (goog.testing.stacktrace.isClosureInspectorActive_()) { - var lineNumber = this.path_.match(/\d+$/)[0]; - canonical.push('<a href="" onclick="CLOSURE_INSPECTOR___.showLine(\'', - htmlEscape(this.path_), '\', \'', lineNumber, '\'); return false">', - htmlEscape(this.path_), '</a>'); - } else { - canonical.push(htmlEscape(this.path_)); - } - } - return canonical.join(''); -}; - - -/** - * Maximum number of steps while the call chain is followed. - * @type {number} - * @private - */ -goog.testing.stacktrace.MAX_DEPTH_ = 20; - - -/** - * Maximum length of a string that can be matched with a RegExp on - * Firefox 3x. Exceeding this approximate length will cause string.match - * to exceed Firefox's stack quota. This situation can be encountered - * when goog.globalEval is invoked with a long argument; such as - * when loading a module. - * @type {number} - * @private - */ -goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_ = 500000; - - -/** - * RegExp pattern for JavaScript identifiers. We don't support Unicode - * identifiers defined in ECMAScript v3. - * @type {string} - * @private - */ -goog.testing.stacktrace.IDENTIFIER_PATTERN_ = '[a-zA-Z_$][\\w$]*'; - - -/** - * RegExp pattern for function name alias in the Chrome stack trace. - * @type {string} - * @private - */ -goog.testing.stacktrace.CHROME_ALIAS_PATTERN_ = - '(?: \\[as (' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')\\])?'; - - -/** - * RegExp pattern for function names and constructor calls in the Chrome stack - * trace. - * @type {string} - * @private - */ -goog.testing.stacktrace.CHROME_FUNCTION_NAME_PATTERN_ = - '(?:new )?(?:' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + - '|<anonymous>)'; - - -/** - * RegExp pattern for function call in the Chrome stack trace. - * Creates 3 submatches with context object (optional), function name and - * function alias (optional). - * @type {string} - * @private - */ -goog.testing.stacktrace.CHROME_FUNCTION_CALL_PATTERN_ = - ' (?:(.*?)\\.)?(' + goog.testing.stacktrace.CHROME_FUNCTION_NAME_PATTERN_ + - ')' + goog.testing.stacktrace.CHROME_ALIAS_PATTERN_; - - -/** - * RegExp pattern for an URL + position inside the file. - * @type {string} - * @private - */ -goog.testing.stacktrace.URL_PATTERN_ = - '((?:http|https|file)://[^\\s)]+|javascript:.*)'; - - -/** - * RegExp pattern for an URL + line number + column number in Chrome. - * The URL is either in submatch 1 or submatch 2. - * @type {string} - * @private - */ -goog.testing.stacktrace.CHROME_URL_PATTERN_ = ' (?:' + - '\\(unknown source\\)' + '|' + - '\\(native\\)' + '|' + - '\\((?:eval at )?' + goog.testing.stacktrace.URL_PATTERN_ + '\\)' + '|' + - goog.testing.stacktrace.URL_PATTERN_ + ')'; - - -/** - * Regular expression for parsing one stack frame in Chrome. - * @type {!RegExp} - * @private - */ -goog.testing.stacktrace.CHROME_STACK_FRAME_REGEXP_ = new RegExp('^ at' + - '(?:' + goog.testing.stacktrace.CHROME_FUNCTION_CALL_PATTERN_ + ')?' + - goog.testing.stacktrace.CHROME_URL_PATTERN_ + '$'); - - -/** - * RegExp pattern for function call in the Firefox stack trace. - * Creates 2 submatches with function name (optional) and arguments. - * @type {string} - * @private - */ -goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ = - '(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')?' + - '(\\(.*\\))?@'; - - -/** - * Regular expression for parsing one stack frame in Firefox. - * @type {!RegExp} - * @private - */ -goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_ = new RegExp('^' + - goog.testing.stacktrace.FIREFOX_FUNCTION_CALL_PATTERN_ + - '(?::0|' + goog.testing.stacktrace.URL_PATTERN_ + ')$'); - - -/** - * RegExp pattern for an anonymous function call in an Opera stack frame. - * Creates 2 (optional) submatches: the context object and function name. - * @type {string} - * @const - * @private - */ -goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ = - '<anonymous function(?:\\: ' + - '(?:(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + - '(?:\\.' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')*)\\.)?' + - '(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + '))?>'; - - -/** - * RegExp pattern for a function call in an Opera stack frame. - * Creates 4 (optional) submatches: the function name (if not anonymous), - * the aliased context object and function name (if anonymous), and the - * function call arguments. - * @type {string} - * @const - * @private - */ -goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ = - '(?:(?:(' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')|' + - goog.testing.stacktrace.OPERA_ANONYMOUS_FUNCTION_NAME_PATTERN_ + - ')(\\(.*\\)))?@'; - - -/** - * Regular expression for parsing on stack frame in Opera 11.68+ - * @type {!RegExp} - * @const - * @private - */ -goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_ = new RegExp('^' + - goog.testing.stacktrace.OPERA_FUNCTION_CALL_PATTERN_ + - goog.testing.stacktrace.URL_PATTERN_ + '?$'); - - -/** - * Regular expression for finding the function name in its source. - * @type {!RegExp} - * @private - */ -goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_ = new RegExp( - '^function (' + goog.testing.stacktrace.IDENTIFIER_PATTERN_ + ')'); - - -/** - * Creates a stack trace by following the call chain. Based on - * {@link goog.debug.getStacktrace}. - * @return {!Array.<!goog.testing.stacktrace.Frame>} Stack frames. - * @private - */ -goog.testing.stacktrace.followCallChain_ = function() { - var frames = []; - var fn = arguments.callee.caller; - var depth = 0; - - while (fn && depth < goog.testing.stacktrace.MAX_DEPTH_) { - var fnString = Function.prototype.toString.call(fn); - var match = fnString.match(goog.testing.stacktrace.FUNCTION_SOURCE_REGEXP_); - var functionName = match ? match[1] : ''; - - var argsBuilder = ['(']; - if (fn.arguments) { - for (var i = 0; i < fn.arguments.length; i++) { - var arg = fn.arguments[i]; - if (i > 0) { - argsBuilder.push(', '); - } - if (goog.isString(arg)) { - argsBuilder.push('"', arg, '"'); - } else { - // Some args are mocks, and we don't want to fail from them not having - // expected a call to toString, so instead insert a static string. - if (arg && arg['$replay']) { - argsBuilder.push('goog.testing.Mock'); - } else { - argsBuilder.push(String(arg)); - } - } - } - } else { - // Opera 10 doesn't know the arguments of native functions. - argsBuilder.push('unknown'); - } - argsBuilder.push(')'); - var args = argsBuilder.join(''); - - frames.push(new goog.testing.stacktrace.Frame('', functionName, '', args, - '')); - - /** @preserveTry */ - try { - fn = fn.caller; - } catch (e) { - break; - } - depth++; - } - - return frames; -}; - - -/** - * Parses one stack frame. - * @param {string} frameStr The stack frame as string. - * @return {goog.testing.stacktrace.Frame} Stack frame object or null if the - * parsing failed. - * @private - */ -goog.testing.stacktrace.parseStackFrame_ = function(frameStr) { - var m = frameStr.match(goog.testing.stacktrace.CHROME_STACK_FRAME_REGEXP_); - if (m) { - return new goog.testing.stacktrace.Frame(m[1] || '', m[2] || '', m[3] || '', - '', m[4] || m[5] || ''); - } - - if (frameStr.length > - goog.testing.stacktrace.MAX_FIREFOX_FRAMESTRING_LENGTH_) { - return goog.testing.stacktrace.parseLongFirefoxFrame_(frameStr); - } - - m = frameStr.match(goog.testing.stacktrace.FIREFOX_STACK_FRAME_REGEXP_); - if (m) { - return new goog.testing.stacktrace.Frame('', m[1] || '', '', m[2] || '', - m[3] || ''); - } - - m = frameStr.match(goog.testing.stacktrace.OPERA_STACK_FRAME_REGEXP_); - if (m) { - return new goog.testing.stacktrace.Frame(m[2] || '', m[1] || m[3] || '', - '', m[4] || '', m[5] || ''); - } - - return null; -}; - - -/** - * Parses a long firefox stack frame. - * @param {string} frameStr The stack frame as string. - * @return {!goog.testing.stacktrace.Frame} Stack frame object. - * @private - */ -goog.testing.stacktrace.parseLongFirefoxFrame_ = function(frameStr) { - var firstParen = frameStr.indexOf('('); - var lastAmpersand = frameStr.lastIndexOf('@'); - var lastColon = frameStr.lastIndexOf(':'); - var functionName = ''; - if ((firstParen >= 0) && (firstParen < lastAmpersand)) { - functionName = frameStr.substring(0, firstParen); - } - var loc = ''; - if ((lastAmpersand >= 0) && (lastAmpersand + 1 < lastColon)) { - loc = frameStr.substring(lastAmpersand + 1); - } - var args = ''; - if ((firstParen >= 0 && lastAmpersand > 0) && - (firstParen < lastAmpersand)) { - args = frameStr.substring(firstParen, lastAmpersand); - } - return new goog.testing.stacktrace.Frame('', functionName, '', args, loc); -}; - - -/** - * Function to deobfuscate function names. - * @type {function(string): string} - * @private - */ -goog.testing.stacktrace.deobfuscateFunctionName_; - - -/** - * Sets function to deobfuscate function names. - * @param {function(string): string} fn function to deobfuscate function names. - */ -goog.testing.stacktrace.setDeobfuscateFunctionName = function(fn) { - goog.testing.stacktrace.deobfuscateFunctionName_ = fn; -}; - - -/** - * Deobfuscates a compiled function name with the function passed to - * {@link #setDeobfuscateFunctionName}. Returns the original function name if - * the deobfuscator hasn't been set. - * @param {string} name The function name to deobfuscate. - * @return {string} The deobfuscated function name. - * @private - */ -goog.testing.stacktrace.maybeDeobfuscateFunctionName_ = function(name) { - return goog.testing.stacktrace.deobfuscateFunctionName_ ? - goog.testing.stacktrace.deobfuscateFunctionName_(name) : name; -}; - - -/** - * @return {boolean} Whether the Closure Inspector is active. - * @private - */ -goog.testing.stacktrace.isClosureInspectorActive_ = function() { - return Boolean(goog.global['CLOSURE_INSPECTOR___'] && - goog.global['CLOSURE_INSPECTOR___']['supportsJSUnit']); -}; - - -/** - * Escapes the special character in HTML. - * @param {string} text Plain text. - * @return {string} Escaped text. - * @private - */ -goog.testing.stacktrace.htmlEscape_ = function(text) { - return text.replace(/&/g, '&'). - replace(/</g, '<'). - replace(/>/g, '>'). - replace(/"/g, '"'); -}; - - -/** - * Converts the stack frames into canonical format. Chops the beginning and the - * end of it which come from the testing environment, not from the test itself. - * @param {!Array.<goog.testing.stacktrace.Frame>} frames The frames. - * @return {string} Canonical, pretty printed stack trace. - * @private - */ -goog.testing.stacktrace.framesToString_ = function(frames) { - // Removes the anonymous calls from the end of the stack trace (they come - // from testrunner.js, testcase.js and asserts.js), so the stack trace will - // end with the test... method. - var lastIndex = frames.length - 1; - while (frames[lastIndex] && frames[lastIndex].isAnonymous()) { - lastIndex--; - } - - // Removes the beginning of the stack trace until the call of the private - // _assert function (inclusive), so the stack trace will begin with a public - // asserter. Does nothing if _assert is not present in the stack trace. - var privateAssertIndex = -1; - for (var i = 0; i < frames.length; i++) { - if (frames[i] && frames[i].getName() == '_assert') { - privateAssertIndex = i; - break; - } - } - - var canonical = []; - for (var i = privateAssertIndex + 1; i <= lastIndex; i++) { - canonical.push('> '); - if (frames[i]) { - canonical.push(frames[i].toCanonicalString()); - } else { - canonical.push('(unknown)'); - } - canonical.push('\n'); - } - return canonical.join(''); -}; - - -/** - * Parses the browser's native stack trace. - * @param {string} stack Stack trace. - * @return {!Array.<goog.testing.stacktrace.Frame>} Stack frames. The - * unrecognized frames will be nulled out. - * @private - */ -goog.testing.stacktrace.parse_ = function(stack) { - var lines = stack.replace(/\s*$/, '').split('\n'); - var frames = []; - for (var i = 0; i < lines.length; i++) { - frames.push(goog.testing.stacktrace.parseStackFrame_(lines[i])); - } - return frames; -}; - - -/** - * Brings the stack trace into a common format across browsers. - * @param {string} stack Browser-specific stack trace. - * @return {string} Same stack trace in common format. - */ -goog.testing.stacktrace.canonicalize = function(stack) { - var frames = goog.testing.stacktrace.parse_(stack); - return goog.testing.stacktrace.framesToString_(frames); -}; - - -/** - * Gets the native stack trace if available otherwise follows the call chain. - * @return {string} The stack trace in canonical format. - */ -goog.testing.stacktrace.get = function() { - var stack = new Error().stack; - var frames = stack ? goog.testing.stacktrace.parse_(stack) : - goog.testing.stacktrace.followCallChain_(); - return goog.testing.stacktrace.framesToString_(frames); -}; - - -goog.exportSymbol('setDeobfuscateFunctionName', - goog.testing.stacktrace.setDeobfuscateFunctionName); |