Javascript
|
2976行
|
76.77 KB
// Copyright 2006-2012 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
// Handle id counters.
var next_handle_ = 0;
var next_transient_handle_ = -1;
// Mirror cache.
var mirror_cache_ = [];
var mirror_cache_enabled_ = true;
function ToggleMirrorCache(value) {
mirror_cache_enabled_ = value;
next_handle_ = 0;
mirror_cache_ = [];
}
// Wrapper to check whether an object is a Promise. The call may not work
// if promises are not enabled.
// TODO(yangguo): remove try-catch once promises are enabled by default.
function ObjectIsPromise(value) {
try {
return IS_SPEC_OBJECT(value) &&
!IS_UNDEFINED(%DebugGetProperty(value, builtins.promiseStatus));
} catch (e) {
return false;
}
}
/**
* Returns the mirror for a specified value or object.
*
* @param {value or Object} value the value or object to retreive the mirror for
* @param {boolean} transient indicate whether this object is transient and
* should not be added to the mirror cache. The default is not transient.
* @returns {Mirror} the mirror reflects the passed value or object
*/
function MakeMirror(value, opt_transient) {
var mirror;
// Look for non transient mirrors in the mirror cache.
if (!opt_transient && mirror_cache_enabled_) {
for (id in mirror_cache_) {
mirror = mirror_cache_[id];
if (mirror.value() === value) {
return mirror;
}
// Special check for NaN as NaN == NaN is false.
if (mirror.isNumber() && isNaN(mirror.value()) &&
typeof value == 'number' && isNaN(value)) {
return mirror;
}
}
}
if (IS_UNDEFINED(value)) {
mirror = new UndefinedMirror();
} else if (IS_NULL(value)) {
mirror = new NullMirror();
} else if (IS_BOOLEAN(value)) {
mirror = new BooleanMirror(value);
} else if (IS_NUMBER(value)) {
mirror = new NumberMirror(value);
} else if (IS_STRING(value)) {
mirror = new StringMirror(value);
} else if (IS_SYMBOL(value)) {
mirror = new SymbolMirror(value);
} else if (IS_ARRAY(value)) {
mirror = new ArrayMirror(value);
} else if (IS_DATE(value)) {
mirror = new DateMirror(value);
} else if (IS_FUNCTION(value)) {
mirror = new FunctionMirror(value);
} else if (IS_REGEXP(value)) {
mirror = new RegExpMirror(value);
} else if (IS_ERROR(value)) {
mirror = new ErrorMirror(value);
} else if (IS_SCRIPT(value)) {
mirror = new ScriptMirror(value);
} else if (IS_MAP(value) || IS_WEAKMAP(value)) {
mirror = new MapMirror(value);
} else if (IS_SET(value) || IS_WEAKSET(value)) {
mirror = new SetMirror(value);
} else if (ObjectIsPromise(value)) {
mirror = new PromiseMirror(value);
} else if (IS_GENERATOR(value)) {
mirror = new GeneratorMirror(value);
} else {
mirror = new ObjectMirror(value, OBJECT_TYPE, opt_transient);
}
if (mirror_cache_enabled_) mirror_cache_[mirror.handle()] = mirror;
return mirror;
}
/**
* Returns the mirror for a specified mirror handle.
*
* @param {number} handle the handle to find the mirror for
* @returns {Mirror or undefiend} the mirror with the requested handle or
* undefined if no mirror with the requested handle was found
*/
function LookupMirror(handle) {
if (!mirror_cache_enabled_) throw new Error("Mirror cache is disabled");
return mirror_cache_[handle];
}
/**
* Returns the mirror for the undefined value.
*
* @returns {Mirror} the mirror reflects the undefined value
*/
function GetUndefinedMirror() {
return MakeMirror(UNDEFINED);
}
/**
* Inherit the prototype methods from one constructor into another.
*
* The Function.prototype.inherits from lang.js rewritten as a standalone
* function (not on Function.prototype). NOTE: If this file is to be loaded
* during bootstrapping this function needs to be revritten using some native
* functions as prototype setup using normal JavaScript does not work as
* expected during bootstrapping (see mirror.js in r114903).
*
* @param {function} ctor Constructor function which needs to inherit the
* prototype
* @param {function} superCtor Constructor function to inherit prototype from
*/
function inherits(ctor, superCtor) {
var tempCtor = function(){};
tempCtor.prototype = superCtor.prototype;
ctor.super_ = superCtor.prototype;
ctor.prototype = new tempCtor();
ctor.prototype.constructor = ctor;
}
// Type names of the different mirrors.
var UNDEFINED_TYPE = 'undefined';
var NULL_TYPE = 'null';
var BOOLEAN_TYPE = 'boolean';
var NUMBER_TYPE = 'number';
var STRING_TYPE = 'string';
var SYMBOL_TYPE = 'symbol';
var OBJECT_TYPE = 'object';
var FUNCTION_TYPE = 'function';
var REGEXP_TYPE = 'regexp';
var ERROR_TYPE = 'error';
var PROPERTY_TYPE = 'property';
var INTERNAL_PROPERTY_TYPE = 'internalProperty';
var FRAME_TYPE = 'frame';
var SCRIPT_TYPE = 'script';
var CONTEXT_TYPE = 'context';
var SCOPE_TYPE = 'scope';
var PROMISE_TYPE = 'promise';
var MAP_TYPE = 'map';
var SET_TYPE = 'set';
var GENERATOR_TYPE = 'generator';
// Maximum length when sending strings through the JSON protocol.
var kMaxProtocolStringLength = 80;
// Different kind of properties.
var PropertyKind = {};
PropertyKind.Named = 1;
PropertyKind.Indexed = 2;
// A copy of the PropertyType enum from property-details.h
var PropertyType = {};
PropertyType.Normal = 0;
PropertyType.Field = 1;
PropertyType.Constant = 2;
PropertyType.Callbacks = 3;
// Different attributes for a property.
var PropertyAttribute = {};
PropertyAttribute.None = NONE;
PropertyAttribute.ReadOnly = READ_ONLY;
PropertyAttribute.DontEnum = DONT_ENUM;
PropertyAttribute.DontDelete = DONT_DELETE;
// A copy of the scope types from runtime.cc.
var ScopeType = { Global: 0,
Local: 1,
With: 2,
Closure: 3,
Catch: 4,
Block: 5 };
// Mirror hierarchy:
// - Mirror
// - ValueMirror
// - UndefinedMirror
// - NullMirror
// - NumberMirror
// - StringMirror
// - SymbolMirror
// - ObjectMirror
// - FunctionMirror
// - UnresolvedFunctionMirror
// - ArrayMirror
// - DateMirror
// - RegExpMirror
// - ErrorMirror
// - PromiseMirror
// - MapMirror
// - SetMirror
// - GeneratorMirror
// - PropertyMirror
// - InternalPropertyMirror
// - FrameMirror
// - ScriptMirror
/**
* Base class for all mirror objects.
* @param {string} type The type of the mirror
* @constructor
*/
function Mirror(type) {
this.type_ = type;
}
Mirror.prototype.type = function() {
return this.type_;
};
/**
* Check whether the mirror reflects a value.
* @returns {boolean} True if the mirror reflects a value.
*/
Mirror.prototype.isValue = function() {
return this instanceof ValueMirror;
};
/**
* Check whether the mirror reflects the undefined value.
* @returns {boolean} True if the mirror reflects the undefined value.
*/
Mirror.prototype.isUndefined = function() {
return this instanceof UndefinedMirror;
};
/**
* Check whether the mirror reflects the null value.
* @returns {boolean} True if the mirror reflects the null value
*/
Mirror.prototype.isNull = function() {
return this instanceof NullMirror;
};
/**
* Check whether the mirror reflects a boolean value.
* @returns {boolean} True if the mirror reflects a boolean value
*/
Mirror.prototype.isBoolean = function() {
return this instanceof BooleanMirror;
};
/**
* Check whether the mirror reflects a number value.
* @returns {boolean} True if the mirror reflects a number value
*/
Mirror.prototype.isNumber = function() {
return this instanceof NumberMirror;
};
/**
* Check whether the mirror reflects a string value.
* @returns {boolean} True if the mirror reflects a string value
*/
Mirror.prototype.isString = function() {
return this instanceof StringMirror;
};
/**
* Check whether the mirror reflects a symbol.
* @returns {boolean} True if the mirror reflects a symbol
*/
Mirror.prototype.isSymbol = function() {
return this instanceof SymbolMirror;
};
/**
* Check whether the mirror reflects an object.
* @returns {boolean} True if the mirror reflects an object
*/
Mirror.prototype.isObject = function() {
return this instanceof ObjectMirror;
};
/**
* Check whether the mirror reflects a function.
* @returns {boolean} True if the mirror reflects a function
*/
Mirror.prototype.isFunction = function() {
return this instanceof FunctionMirror;
};
/**
* Check whether the mirror reflects an unresolved function.
* @returns {boolean} True if the mirror reflects an unresolved function
*/
Mirror.prototype.isUnresolvedFunction = function() {
return this instanceof UnresolvedFunctionMirror;
};
/**
* Check whether the mirror reflects an array.
* @returns {boolean} True if the mirror reflects an array
*/
Mirror.prototype.isArray = function() {
return this instanceof ArrayMirror;
};
/**
* Check whether the mirror reflects a date.
* @returns {boolean} True if the mirror reflects a date
*/
Mirror.prototype.isDate = function() {
return this instanceof DateMirror;
};
/**
* Check whether the mirror reflects a regular expression.
* @returns {boolean} True if the mirror reflects a regular expression
*/
Mirror.prototype.isRegExp = function() {
return this instanceof RegExpMirror;
};
/**
* Check whether the mirror reflects an error.
* @returns {boolean} True if the mirror reflects an error
*/
Mirror.prototype.isError = function() {
return this instanceof ErrorMirror;
};
/**
* Check whether the mirror reflects a promise.
* @returns {boolean} True if the mirror reflects a promise
*/
Mirror.prototype.isPromise = function() {
return this instanceof PromiseMirror;
};
/**
* Check whether the mirror reflects a generator object.
* @returns {boolean} True if the mirror reflects a generator object
*/
Mirror.prototype.isGenerator = function() {
return this instanceof GeneratorMirror;
};
/**
* Check whether the mirror reflects a property.
* @returns {boolean} True if the mirror reflects a property
*/
Mirror.prototype.isProperty = function() {
return this instanceof PropertyMirror;
};
/**
* Check whether the mirror reflects an internal property.
* @returns {boolean} True if the mirror reflects an internal property
*/
Mirror.prototype.isInternalProperty = function() {
return this instanceof InternalPropertyMirror;
};
/**
* Check whether the mirror reflects a stack frame.
* @returns {boolean} True if the mirror reflects a stack frame
*/
Mirror.prototype.isFrame = function() {
return this instanceof FrameMirror;
};
/**
* Check whether the mirror reflects a script.
* @returns {boolean} True if the mirror reflects a script
*/
Mirror.prototype.isScript = function() {
return this instanceof ScriptMirror;
};
/**
* Check whether the mirror reflects a context.
* @returns {boolean} True if the mirror reflects a context
*/
Mirror.prototype.isContext = function() {
return this instanceof ContextMirror;
};
/**
* Check whether the mirror reflects a scope.
* @returns {boolean} True if the mirror reflects a scope
*/
Mirror.prototype.isScope = function() {
return this instanceof ScopeMirror;
};
/**
* Check whether the mirror reflects a map.
* @returns {boolean} True if the mirror reflects a map
*/
Mirror.prototype.isMap = function() {
return this instanceof MapMirror;
};
/**
* Check whether the mirror reflects a set.
* @returns {boolean} True if the mirror reflects a set
*/
Mirror.prototype.isSet = function() {
return this instanceof SetMirror;
};
/**
* Allocate a handle id for this object.
*/
Mirror.prototype.allocateHandle_ = function() {
if (mirror_cache_enabled_) this.handle_ = next_handle_++;
};
/**
* Allocate a transient handle id for this object. Transient handles are
* negative.
*/
Mirror.prototype.allocateTransientHandle_ = function() {
this.handle_ = next_transient_handle_--;
};
Mirror.prototype.toText = function() {
// Simpel to text which is used when on specialization in subclass.
return "#<" + this.constructor.name + ">";
};
/**
* Base class for all value mirror objects.
* @param {string} type The type of the mirror
* @param {value} value The value reflected by this mirror
* @param {boolean} transient indicate whether this object is transient with a
* transient handle
* @constructor
* @extends Mirror
*/
function ValueMirror(type, value, transient) {
%_CallFunction(this, type, Mirror);
this.value_ = value;
if (!transient) {
this.allocateHandle_();
} else {
this.allocateTransientHandle_();
}
}
inherits(ValueMirror, Mirror);
Mirror.prototype.handle = function() {
return this.handle_;
};
/**
* Check whether this is a primitive value.
* @return {boolean} True if the mirror reflects a primitive value
*/
ValueMirror.prototype.isPrimitive = function() {
var type = this.type();
return type === 'undefined' ||
type === 'null' ||
type === 'boolean' ||
type === 'number' ||
type === 'string' ||
type === 'symbol';
};
/**
* Get the actual value reflected by this mirror.
* @return {value} The value reflected by this mirror
*/
ValueMirror.prototype.value = function() {
return this.value_;
};
/**
* Mirror object for Undefined.
* @constructor
* @extends ValueMirror
*/
function UndefinedMirror() {
%_CallFunction(this, UNDEFINED_TYPE, UNDEFINED, ValueMirror);
}
inherits(UndefinedMirror, ValueMirror);
UndefinedMirror.prototype.toText = function() {
return 'undefined';
};
/**
* Mirror object for null.
* @constructor
* @extends ValueMirror
*/
function NullMirror() {
%_CallFunction(this, NULL_TYPE, null, ValueMirror);
}
inherits(NullMirror, ValueMirror);
NullMirror.prototype.toText = function() {
return 'null';
};
/**
* Mirror object for boolean values.
* @param {boolean} value The boolean value reflected by this mirror
* @constructor
* @extends ValueMirror
*/
function BooleanMirror(value) {
%_CallFunction(this, BOOLEAN_TYPE, value, ValueMirror);
}
inherits(BooleanMirror, ValueMirror);
BooleanMirror.prototype.toText = function() {
return this.value_ ? 'true' : 'false';
};
/**
* Mirror object for number values.
* @param {number} value The number value reflected by this mirror
* @constructor
* @extends ValueMirror
*/
function NumberMirror(value) {
%_CallFunction(this, NUMBER_TYPE, value, ValueMirror);
}
inherits(NumberMirror, ValueMirror);
NumberMirror.prototype.toText = function() {
return %_NumberToString(this.value_);
};
/**
* Mirror object for string values.
* @param {string} value The string value reflected by this mirror
* @constructor
* @extends ValueMirror
*/
function StringMirror(value) {
%_CallFunction(this, STRING_TYPE, value, ValueMirror);
}
inherits(StringMirror, ValueMirror);
StringMirror.prototype.length = function() {
return this.value_.length;
};
StringMirror.prototype.getTruncatedValue = function(maxLength) {
if (maxLength != -1 && this.length() > maxLength) {
return this.value_.substring(0, maxLength) +
'... (length: ' + this.length() + ')';
}
return this.value_;
};
StringMirror.prototype.toText = function() {
return this.getTruncatedValue(kMaxProtocolStringLength);
};
/**
* Mirror object for a Symbol
* @param {Object} value The Symbol
* @constructor
* @extends Mirror
*/
function SymbolMirror(value) {
%_CallFunction(this, SYMBOL_TYPE, value, ValueMirror);
}
inherits(SymbolMirror, ValueMirror);
SymbolMirror.prototype.description = function() {
return %SymbolDescription(%_ValueOf(this.value_));
}
SymbolMirror.prototype.toText = function() {
return %_CallFunction(this.value_, builtins.SymbolToString);
}
/**
* Mirror object for objects.
* @param {object} value The object reflected by this mirror
* @param {boolean} transient indicate whether this object is transient with a
* transient handle
* @constructor
* @extends ValueMirror
*/
function ObjectMirror(value, type, transient) {
%_CallFunction(this, type || OBJECT_TYPE, value, transient, ValueMirror);
}
inherits(ObjectMirror, ValueMirror);
ObjectMirror.prototype.className = function() {
return %_ClassOf(this.value_);
};
ObjectMirror.prototype.constructorFunction = function() {
return MakeMirror(%DebugGetProperty(this.value_, 'constructor'));
};
ObjectMirror.prototype.prototypeObject = function() {
return MakeMirror(%DebugGetProperty(this.value_, 'prototype'));
};
ObjectMirror.prototype.protoObject = function() {
return MakeMirror(%DebugGetPrototype(this.value_));
};
ObjectMirror.prototype.hasNamedInterceptor = function() {
// Get information on interceptors for this object.
var x = %GetInterceptorInfo(this.value_);
return (x & 2) != 0;
};
ObjectMirror.prototype.hasIndexedInterceptor = function() {
// Get information on interceptors for this object.
var x = %GetInterceptorInfo(this.value_);
return (x & 1) != 0;
};
// Get all own property names except for private symbols.
function TryGetPropertyNames(object) {
try {
// TODO(yangguo): Should there be a special debugger implementation of
// %GetOwnPropertyNames that doesn't perform access checks?
return %GetOwnPropertyNames(object, PROPERTY_ATTRIBUTES_PRIVATE_SYMBOL);
} catch (e) {
// Might have hit a failed access check.
return [];
}
}
/**
* Return the property names for this object.
* @param {number} kind Indicate whether named, indexed or both kinds of
* properties are requested
* @param {number} limit Limit the number of names returend to the specified
value
* @return {Array} Property names for this object
*/
ObjectMirror.prototype.propertyNames = function(kind, limit) {
// Find kind and limit and allocate array for the result
kind = kind || PropertyKind.Named | PropertyKind.Indexed;
var propertyNames;
var elementNames;
var total = 0;
// Find all the named properties.
if (kind & PropertyKind.Named) {
propertyNames = TryGetPropertyNames(this.value_);
total += propertyNames.length;
// Get names for named interceptor properties if any.
if (this.hasNamedInterceptor() && (kind & PropertyKind.Named)) {
var namedInterceptorNames =
%GetNamedInterceptorPropertyNames(this.value_);
if (namedInterceptorNames) {
propertyNames = propertyNames.concat(namedInterceptorNames);
total += namedInterceptorNames.length;
}
}
}
// Find all the indexed properties.
if (kind & PropertyKind.Indexed) {
// Get own element names.
elementNames = %GetOwnElementNames(this.value_);
total += elementNames.length;
// Get names for indexed interceptor properties.
if (this.hasIndexedInterceptor() && (kind & PropertyKind.Indexed)) {
var indexedInterceptorNames =
%GetIndexedInterceptorElementNames(this.value_);
if (indexedInterceptorNames) {
elementNames = elementNames.concat(indexedInterceptorNames);
total += indexedInterceptorNames.length;
}
}
}
limit = Math.min(limit || total, total);
var names = new Array(limit);
var index = 0;
// Copy names for named properties.
if (kind & PropertyKind.Named) {
for (var i = 0; index < limit && i < propertyNames.length; i++) {
names[index++] = propertyNames[i];
}
}
// Copy names for indexed properties.
if (kind & PropertyKind.Indexed) {
for (var i = 0; index < limit && i < elementNames.length; i++) {
names[index++] = elementNames[i];
}
}
return names;
};
/**
* Return the properties for this object as an array of PropertyMirror objects.
* @param {number} kind Indicate whether named, indexed or both kinds of
* properties are requested
* @param {number} limit Limit the number of properties returned to the
specified value
* @return {Array} Property mirrors for this object
*/
ObjectMirror.prototype.properties = function(kind, limit) {
var names = this.propertyNames(kind, limit);
var properties = new Array(names.length);
for (var i = 0; i < names.length; i++) {
properties[i] = this.property(names[i]);
}
return properties;
};
/**
* Return the internal properties for this object as an array of
* InternalPropertyMirror objects.
* @return {Array} Property mirrors for this object
*/
ObjectMirror.prototype.internalProperties = function() {
return ObjectMirror.GetInternalProperties(this.value_);
}
ObjectMirror.prototype.property = function(name) {
var details = %DebugGetPropertyDetails(this.value_, %ToName(name));
if (details) {
return new PropertyMirror(this, name, details);
}
// Nothing found.
return GetUndefinedMirror();
};
/**
* Try to find a property from its value.
* @param {Mirror} value The property value to look for
* @return {PropertyMirror} The property with the specified value. If no
* property was found with the specified value UndefinedMirror is returned
*/
ObjectMirror.prototype.lookupProperty = function(value) {
var properties = this.properties();
// Look for property value in properties.
for (var i = 0; i < properties.length; i++) {
// Skip properties which are defined through assessors.
var property = properties[i];
if (property.propertyType() != PropertyType.Callbacks) {
if (%_ObjectEquals(property.value_, value.value_)) {
return property;
}
}
}
// Nothing found.
return GetUndefinedMirror();
};
/**
* Returns objects which has direct references to this object
* @param {number} opt_max_objects Optional parameter specifying the maximum
* number of referencing objects to return.
* @return {Array} The objects which has direct references to this object.
*/
ObjectMirror.prototype.referencedBy = function(opt_max_objects) {
// Find all objects with direct references to this object.
var result = %DebugReferencedBy(this.value_,
Mirror.prototype, opt_max_objects || 0);
// Make mirrors for all the references found.
for (var i = 0; i < result.length; i++) {
result[i] = MakeMirror(result[i]);
}
return result;
};
ObjectMirror.prototype.toText = function() {
var name;
var ctor = this.constructorFunction();
if (!ctor.isFunction()) {
name = this.className();
} else {
name = ctor.name();
if (!name) {
name = this.className();
}
}
return '#<' + name + '>';
};
/**
* Return the internal properties of the value, such as [[PrimitiveValue]] of
* scalar wrapper objects, properties of the bound function and properties of
* the promise.
* This method is done static to be accessible from Debug API with the bare
* values without mirrors.
* @return {Array} array (possibly empty) of InternalProperty instances
*/
ObjectMirror.GetInternalProperties = function(value) {
if (IS_STRING_WRAPPER(value) || IS_NUMBER_WRAPPER(value) ||
IS_BOOLEAN_WRAPPER(value)) {
var primitiveValue = %_ValueOf(value);
return [new InternalPropertyMirror("[[PrimitiveValue]]", primitiveValue)];
} else if (IS_FUNCTION(value)) {
var bindings = %BoundFunctionGetBindings(value);
var result = [];
if (bindings && IS_ARRAY(bindings)) {
result.push(new InternalPropertyMirror("[[TargetFunction]]",
bindings[0]));
result.push(new InternalPropertyMirror("[[BoundThis]]", bindings[1]));
var boundArgs = [];
for (var i = 2; i < bindings.length; i++) {
boundArgs.push(bindings[i]);
}
result.push(new InternalPropertyMirror("[[BoundArgs]]", boundArgs));
}
return result;
} else if (ObjectIsPromise(value)) {
var result = [];
result.push(new InternalPropertyMirror("[[PromiseStatus]]",
PromiseGetStatus_(value)));
result.push(new InternalPropertyMirror("[[PromiseValue]]",
PromiseGetValue_(value)));
return result;
}
return [];
}
/**
* Mirror object for functions.
* @param {function} value The function object reflected by this mirror.
* @constructor
* @extends ObjectMirror
*/
function FunctionMirror(value) {
%_CallFunction(this, value, FUNCTION_TYPE, ObjectMirror);
this.resolved_ = true;
}
inherits(FunctionMirror, ObjectMirror);
/**
* Returns whether the function is resolved.
* @return {boolean} True if the function is resolved. Unresolved functions can
* only originate as functions from stack frames
*/
FunctionMirror.prototype.resolved = function() {
return this.resolved_;
};
/**
* Returns the name of the function.
* @return {string} Name of the function
*/
FunctionMirror.prototype.name = function() {
return %FunctionGetName(this.value_);
};
/**
* Returns the inferred name of the function.
* @return {string} Name of the function
*/
FunctionMirror.prototype.inferredName = function() {
return %FunctionGetInferredName(this.value_);
};
/**
* Returns the source code for the function.
* @return {string or undefined} The source code for the function. If the
* function is not resolved undefined will be returned.
*/
FunctionMirror.prototype.source = function() {
// Return source if function is resolved. Otherwise just fall through to
// return undefined.
if (this.resolved()) {
return builtins.FunctionSourceString(this.value_);
}
};
/**
* Returns the script object for the function.
* @return {ScriptMirror or undefined} Script object for the function or
* undefined if the function has no script
*/
FunctionMirror.prototype.script = function() {
// Return script if function is resolved. Otherwise just fall through
// to return undefined.
if (this.resolved()) {
if (this.script_) {
return this.script_;
}
var script = %FunctionGetScript(this.value_);
if (script) {
return this.script_ = MakeMirror(script);
}
}
};
/**
* Returns the script source position for the function. Only makes sense
* for functions which has a script defined.
* @return {Number or undefined} in-script position for the function
*/
FunctionMirror.prototype.sourcePosition_ = function() {
// Return position if function is resolved. Otherwise just fall
// through to return undefined.
if (this.resolved()) {
return %FunctionGetScriptSourcePosition(this.value_);
}
};
/**
* Returns the script source location object for the function. Only makes sense
* for functions which has a script defined.
* @return {Location or undefined} in-script location for the function begin
*/
FunctionMirror.prototype.sourceLocation = function() {
if (this.resolved()) {
var script = this.script();
if (script) {
return script.locationFromPosition(this.sourcePosition_(), true);
}
}
};
/**
* Returns objects constructed by this function.
* @param {number} opt_max_instances Optional parameter specifying the maximum
* number of instances to return.
* @return {Array or undefined} The objects constructed by this function.
*/
FunctionMirror.prototype.constructedBy = function(opt_max_instances) {
if (this.resolved()) {
// Find all objects constructed from this function.
var result = %DebugConstructedBy(this.value_, opt_max_instances || 0);
// Make mirrors for all the instances found.
for (var i = 0; i < result.length; i++) {
result[i] = MakeMirror(result[i]);
}
return result;
} else {
return [];
}
};
FunctionMirror.prototype.scopeCount = function() {
if (this.resolved()) {
if (IS_UNDEFINED(this.scopeCount_)) {
this.scopeCount_ = %GetFunctionScopeCount(this.value());
}
return this.scopeCount_;
} else {
return 0;
}
};
FunctionMirror.prototype.scope = function(index) {
if (this.resolved()) {
return new ScopeMirror(UNDEFINED, this, index);
}
};
FunctionMirror.prototype.toText = function() {
return this.source();
};
/**
* Mirror object for unresolved functions.
* @param {string} value The name for the unresolved function reflected by this
* mirror.
* @constructor
* @extends ObjectMirror
*/
function UnresolvedFunctionMirror(value) {
// Construct this using the ValueMirror as an unresolved function is not a
// real object but just a string.
%_CallFunction(this, FUNCTION_TYPE, value, ValueMirror);
this.propertyCount_ = 0;
this.elementCount_ = 0;
this.resolved_ = false;
}
inherits(UnresolvedFunctionMirror, FunctionMirror);
UnresolvedFunctionMirror.prototype.className = function() {
return 'Function';
};
UnresolvedFunctionMirror.prototype.constructorFunction = function() {
return GetUndefinedMirror();
};
UnresolvedFunctionMirror.prototype.prototypeObject = function() {
return GetUndefinedMirror();
};
UnresolvedFunctionMirror.prototype.protoObject = function() {
return GetUndefinedMirror();
};
UnresolvedFunctionMirror.prototype.name = function() {
return this.value_;
};
UnresolvedFunctionMirror.prototype.inferredName = function() {
return undefined;
};
UnresolvedFunctionMirror.prototype.propertyNames = function(kind, limit) {
return [];
};
/**
* Mirror object for arrays.
* @param {Array} value The Array object reflected by this mirror
* @constructor
* @extends ObjectMirror
*/
function ArrayMirror(value) {
%_CallFunction(this, value, ObjectMirror);
}
inherits(ArrayMirror, ObjectMirror);
ArrayMirror.prototype.length = function() {
return this.value_.length;
};
ArrayMirror.prototype.indexedPropertiesFromRange = function(opt_from_index,
opt_to_index) {
var from_index = opt_from_index || 0;
var to_index = opt_to_index || this.length() - 1;
if (from_index > to_index) return new Array();
var values = new Array(to_index - from_index + 1);
for (var i = from_index; i <= to_index; i++) {
var details = %DebugGetPropertyDetails(this.value_, %ToString(i));
var value;
if (details) {
value = new PropertyMirror(this, i, details);
} else {
value = GetUndefinedMirror();
}
values[i - from_index] = value;
}
return values;
};
/**
* Mirror object for dates.
* @param {Date} value The Date object reflected by this mirror
* @constructor
* @extends ObjectMirror
*/
function DateMirror(value) {
%_CallFunction(this, value, ObjectMirror);
}
inherits(DateMirror, ObjectMirror);
DateMirror.prototype.toText = function() {
var s = JSON.stringify(this.value_);
return s.substring(1, s.length - 1); // cut quotes
};
/**
* Mirror object for regular expressions.
* @param {RegExp} value The RegExp object reflected by this mirror
* @constructor
* @extends ObjectMirror
*/
function RegExpMirror(value) {
%_CallFunction(this, value, REGEXP_TYPE, ObjectMirror);
}
inherits(RegExpMirror, ObjectMirror);
/**
* Returns the source to the regular expression.
* @return {string or undefined} The source to the regular expression
*/
RegExpMirror.prototype.source = function() {
return this.value_.source;
};
/**
* Returns whether this regular expression has the global (g) flag set.
* @return {boolean} Value of the global flag
*/
RegExpMirror.prototype.global = function() {
return this.value_.global;
};
/**
* Returns whether this regular expression has the ignore case (i) flag set.
* @return {boolean} Value of the ignore case flag
*/
RegExpMirror.prototype.ignoreCase = function() {
return this.value_.ignoreCase;
};
/**
* Returns whether this regular expression has the multiline (m) flag set.
* @return {boolean} Value of the multiline flag
*/
RegExpMirror.prototype.multiline = function() {
return this.value_.multiline;
};
RegExpMirror.prototype.toText = function() {
// Simpel to text which is used when on specialization in subclass.
return "/" + this.source() + "/";
};
/**
* Mirror object for error objects.
* @param {Error} value The error object reflected by this mirror
* @constructor
* @extends ObjectMirror
*/
function ErrorMirror(value) {
%_CallFunction(this, value, ERROR_TYPE, ObjectMirror);
}
inherits(ErrorMirror, ObjectMirror);
/**
* Returns the message for this eror object.
* @return {string or undefined} The message for this eror object
*/
ErrorMirror.prototype.message = function() {
return this.value_.message;
};
ErrorMirror.prototype.toText = function() {
// Use the same text representation as in messages.js.
var text;
try {
str = %_CallFunction(this.value_, builtins.ErrorToString);
} catch (e) {
str = '#<Error>';
}
return str;
};
/**
* Mirror object for a Promise object.
* @param {Object} value The Promise object
* @constructor
* @extends ObjectMirror
*/
function PromiseMirror(value) {
%_CallFunction(this, value, PROMISE_TYPE, ObjectMirror);
}
inherits(PromiseMirror, ObjectMirror);
function PromiseGetStatus_(value) {
var status = %DebugGetProperty(value, builtins.promiseStatus);
if (status == 0) return "pending";
if (status == 1) return "resolved";
return "rejected";
}
function PromiseGetValue_(value) {
return %DebugGetProperty(value, builtins.promiseValue);
}
PromiseMirror.prototype.status = function() {
return PromiseGetStatus_(this.value_);
};
PromiseMirror.prototype.promiseValue = function() {
return MakeMirror(PromiseGetValue_(this.value_));
};
function MapMirror(value) {
%_CallFunction(this, value, MAP_TYPE, ObjectMirror);
}
inherits(MapMirror, ObjectMirror);
/**
* Returns an array of key/value pairs of a map.
* This will keep keys alive for WeakMaps.
*
* @returns {Array.<Object>} Array of key/value pairs of a map.
*/
MapMirror.prototype.entries = function() {
var result = [];
if (IS_WEAKMAP(this.value_)) {
var entries = %GetWeakMapEntries(this.value_);
for (var i = 0; i < entries.length; i += 2) {
result.push({
key: entries[i],
value: entries[i + 1]
});
}
return result;
}
var iter = %_CallFunction(this.value_, builtins.MapEntries);
var next;
while (!(next = iter.next()).done) {
result.push({
key: next.value[0],
value: next.value[1]
});
}
return result;
};
function SetMirror(value) {
%_CallFunction(this, value, SET_TYPE, ObjectMirror);
}
inherits(SetMirror, ObjectMirror);
/**
* Returns an array of elements of a set.
* This will keep elements alive for WeakSets.
*
* @returns {Array.<Object>} Array of elements of a set.
*/
SetMirror.prototype.values = function() {
if (IS_WEAKSET(this.value_)) {
return %GetWeakSetValues(this.value_);
}
var result = [];
var iter = %_CallFunction(this.value_, builtins.SetValues);
var next;
while (!(next = iter.next()).done) {
result.push(next.value);
}
return result;
};
/**
* Mirror object for a Generator object.
* @param {Object} data The Generator object
* @constructor
* @extends Mirror
*/
function GeneratorMirror(value) {
%_CallFunction(this, value, GENERATOR_TYPE, ObjectMirror);
}
inherits(GeneratorMirror, ObjectMirror);
GeneratorMirror.prototype.status = function() {
var continuation = %GeneratorGetContinuation(this.value_);
if (continuation < 0) return "running";
if (continuation == 0) return "closed";
return "suspended";
};
GeneratorMirror.prototype.sourcePosition_ = function() {
return %GeneratorGetSourcePosition(this.value_);
};
GeneratorMirror.prototype.sourceLocation = function() {
var pos = this.sourcePosition_();
if (!IS_UNDEFINED(pos)) {
var script = this.func().script();
if (script) {
return script.locationFromPosition(pos, true);
}
}
};
GeneratorMirror.prototype.func = function() {
if (!this.func_) {
this.func_ = MakeMirror(%GeneratorGetFunction(this.value_));
}
return this.func_;
};
GeneratorMirror.prototype.context = function() {
if (!this.context_) {
this.context_ = new ContextMirror(%GeneratorGetContext(this.value_));
}
return this.context_;
};
GeneratorMirror.prototype.receiver = function() {
if (!this.receiver_) {
this.receiver_ = MakeMirror(%GeneratorGetReceiver(this.value_));
}
return this.receiver_;
};
/**
* Base mirror object for properties.
* @param {ObjectMirror} mirror The mirror object having this property
* @param {string} name The name of the property
* @param {Array} details Details about the property
* @constructor
* @extends Mirror
*/
function PropertyMirror(mirror, name, details) {
%_CallFunction(this, PROPERTY_TYPE, Mirror);
this.mirror_ = mirror;
this.name_ = name;
this.value_ = details[0];
this.details_ = details[1];
this.is_interceptor_ = details[2];
if (details.length > 3) {
this.exception_ = details[3];
this.getter_ = details[4];
this.setter_ = details[5];
}
}
inherits(PropertyMirror, Mirror);
PropertyMirror.prototype.isReadOnly = function() {
return (this.attributes() & PropertyAttribute.ReadOnly) != 0;
};
PropertyMirror.prototype.isEnum = function() {
return (this.attributes() & PropertyAttribute.DontEnum) == 0;
};
PropertyMirror.prototype.canDelete = function() {
return (this.attributes() & PropertyAttribute.DontDelete) == 0;
};
PropertyMirror.prototype.name = function() {
return this.name_;
};
PropertyMirror.prototype.isIndexed = function() {
for (var i = 0; i < this.name_.length; i++) {
if (this.name_[i] < '0' || '9' < this.name_[i]) {
return false;
}
}
return true;
};
PropertyMirror.prototype.value = function() {
return MakeMirror(this.value_, false);
};
/**
* Returns whether this property value is an exception.
* @return {booolean} True if this property value is an exception
*/
PropertyMirror.prototype.isException = function() {
return this.exception_ ? true : false;
};
PropertyMirror.prototype.attributes = function() {
return %DebugPropertyAttributesFromDetails(this.details_);
};
PropertyMirror.prototype.propertyType = function() {
return %DebugPropertyTypeFromDetails(this.details_);
};
PropertyMirror.prototype.insertionIndex = function() {
return %DebugPropertyIndexFromDetails(this.details_);
};
/**
* Returns whether this property has a getter defined through __defineGetter__.
* @return {booolean} True if this property has a getter
*/
PropertyMirror.prototype.hasGetter = function() {
return this.getter_ ? true : false;
};
/**
* Returns whether this property has a setter defined through __defineSetter__.
* @return {booolean} True if this property has a setter
*/
PropertyMirror.prototype.hasSetter = function() {
return this.setter_ ? true : false;
};
/**
* Returns the getter for this property defined through __defineGetter__.
* @return {Mirror} FunctionMirror reflecting the getter function or
* UndefinedMirror if there is no getter for this property
*/
PropertyMirror.prototype.getter = function() {
if (this.hasGetter()) {
return MakeMirror(this.getter_);
} else {
return GetUndefinedMirror();
}
};
/**
* Returns the setter for this property defined through __defineSetter__.
* @return {Mirror} FunctionMirror reflecting the setter function or
* UndefinedMirror if there is no setter for this property
*/
PropertyMirror.prototype.setter = function() {
if (this.hasSetter()) {
return MakeMirror(this.setter_);
} else {
return GetUndefinedMirror();
}
};
/**
* Returns whether this property is natively implemented by the host or a set
* through JavaScript code.
* @return {boolean} True if the property is
* UndefinedMirror if there is no setter for this property
*/
PropertyMirror.prototype.isNative = function() {
return this.is_interceptor_ ||
((this.propertyType() == PropertyType.Callbacks) &&
!this.hasGetter() && !this.hasSetter());
};
/**
* Mirror object for internal properties. Internal property reflects properties
* not accessible from user code such as [[BoundThis]] in bound function.
* Their names are merely symbolic.
* @param {string} name The name of the property
* @param {value} property value
* @constructor
* @extends Mirror
*/
function InternalPropertyMirror(name, value) {
%_CallFunction(this, INTERNAL_PROPERTY_TYPE, Mirror);
this.name_ = name;
this.value_ = value;
}
inherits(InternalPropertyMirror, Mirror);
InternalPropertyMirror.prototype.name = function() {
return this.name_;
};
InternalPropertyMirror.prototype.value = function() {
return MakeMirror(this.value_, false);
};
var kFrameDetailsFrameIdIndex = 0;
var kFrameDetailsReceiverIndex = 1;
var kFrameDetailsFunctionIndex = 2;
var kFrameDetailsArgumentCountIndex = 3;
var kFrameDetailsLocalCountIndex = 4;
var kFrameDetailsSourcePositionIndex = 5;
var kFrameDetailsConstructCallIndex = 6;
var kFrameDetailsAtReturnIndex = 7;
var kFrameDetailsFlagsIndex = 8;
var kFrameDetailsFirstDynamicIndex = 9;
var kFrameDetailsNameIndex = 0;
var kFrameDetailsValueIndex = 1;
var kFrameDetailsNameValueSize = 2;
var kFrameDetailsFlagDebuggerFrameMask = 1 << 0;
var kFrameDetailsFlagOptimizedFrameMask = 1 << 1;
var kFrameDetailsFlagInlinedFrameIndexMask = 7 << 2;
/**
* Wrapper for the frame details information retreived from the VM. The frame
* details from the VM is an array with the following content. See runtime.cc
* Runtime_GetFrameDetails.
* 0: Id
* 1: Receiver
* 2: Function
* 3: Argument count
* 4: Local count
* 5: Source position
* 6: Construct call
* 7: Is at return
* 8: Flags (debugger frame, optimized frame, inlined frame index)
* Arguments name, value
* Locals name, value
* Return value if any
* @param {number} break_id Current break id
* @param {number} index Frame number
* @constructor
*/
function FrameDetails(break_id, index) {
this.break_id_ = break_id;
this.details_ = %GetFrameDetails(break_id, index);
}
FrameDetails.prototype.frameId = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsFrameIdIndex];
};
FrameDetails.prototype.receiver = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsReceiverIndex];
};
FrameDetails.prototype.func = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsFunctionIndex];
};
FrameDetails.prototype.isConstructCall = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsConstructCallIndex];
};
FrameDetails.prototype.isAtReturn = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsAtReturnIndex];
};
FrameDetails.prototype.isDebuggerFrame = function() {
%CheckExecutionState(this.break_id_);
var f = kFrameDetailsFlagDebuggerFrameMask;
return (this.details_[kFrameDetailsFlagsIndex] & f) == f;
};
FrameDetails.prototype.isOptimizedFrame = function() {
%CheckExecutionState(this.break_id_);
var f = kFrameDetailsFlagOptimizedFrameMask;
return (this.details_[kFrameDetailsFlagsIndex] & f) == f;
};
FrameDetails.prototype.isInlinedFrame = function() {
return this.inlinedFrameIndex() > 0;
};
FrameDetails.prototype.inlinedFrameIndex = function() {
%CheckExecutionState(this.break_id_);
var f = kFrameDetailsFlagInlinedFrameIndexMask;
return (this.details_[kFrameDetailsFlagsIndex] & f) >> 2;
};
FrameDetails.prototype.argumentCount = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsArgumentCountIndex];
};
FrameDetails.prototype.argumentName = function(index) {
%CheckExecutionState(this.break_id_);
if (index >= 0 && index < this.argumentCount()) {
return this.details_[kFrameDetailsFirstDynamicIndex +
index * kFrameDetailsNameValueSize +
kFrameDetailsNameIndex];
}
};
FrameDetails.prototype.argumentValue = function(index) {
%CheckExecutionState(this.break_id_);
if (index >= 0 && index < this.argumentCount()) {
return this.details_[kFrameDetailsFirstDynamicIndex +
index * kFrameDetailsNameValueSize +
kFrameDetailsValueIndex];
}
};
FrameDetails.prototype.localCount = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsLocalCountIndex];
};
FrameDetails.prototype.sourcePosition = function() {
%CheckExecutionState(this.break_id_);
return this.details_[kFrameDetailsSourcePositionIndex];
};
FrameDetails.prototype.localName = function(index) {
%CheckExecutionState(this.break_id_);
if (index >= 0 && index < this.localCount()) {
var locals_offset = kFrameDetailsFirstDynamicIndex +
this.argumentCount() * kFrameDetailsNameValueSize;
return this.details_[locals_offset +
index * kFrameDetailsNameValueSize +
kFrameDetailsNameIndex];
}
};
FrameDetails.prototype.localValue = function(index) {
%CheckExecutionState(this.break_id_);
if (index >= 0 && index < this.localCount()) {
var locals_offset = kFrameDetailsFirstDynamicIndex +
this.argumentCount() * kFrameDetailsNameValueSize;
return this.details_[locals_offset +
index * kFrameDetailsNameValueSize +
kFrameDetailsValueIndex];
}
};
FrameDetails.prototype.returnValue = function() {
%CheckExecutionState(this.break_id_);
var return_value_offset =
kFrameDetailsFirstDynamicIndex +
(this.argumentCount() + this.localCount()) * kFrameDetailsNameValueSize;
if (this.details_[kFrameDetailsAtReturnIndex]) {
return this.details_[return_value_offset];
}
};
FrameDetails.prototype.scopeCount = function() {
if (IS_UNDEFINED(this.scopeCount_)) {
this.scopeCount_ = %GetScopeCount(this.break_id_, this.frameId());
}
return this.scopeCount_;
};
FrameDetails.prototype.stepInPositionsImpl = function() {
return %GetStepInPositions(this.break_id_, this.frameId());
};
/**
* Mirror object for stack frames.
* @param {number} break_id The break id in the VM for which this frame is
valid
* @param {number} index The frame index (top frame is index 0)
* @constructor
* @extends Mirror
*/
function FrameMirror(break_id, index) {
%_CallFunction(this, FRAME_TYPE, Mirror);
this.break_id_ = break_id;
this.index_ = index;
this.details_ = new FrameDetails(break_id, index);
}
inherits(FrameMirror, Mirror);
FrameMirror.prototype.details = function() {
return this.details_;
};
FrameMirror.prototype.index = function() {
return this.index_;
};
FrameMirror.prototype.func = function() {
if (this.func_) {
return this.func_;
}
// Get the function for this frame from the VM.
var f = this.details_.func();
// Create a function mirror. NOTE: MakeMirror cannot be used here as the
// value returned from the VM might be a string if the function for the
// frame is unresolved.
if (IS_FUNCTION(f)) {
return this.func_ = MakeMirror(f);
} else {
return new UnresolvedFunctionMirror(f);
}
};
FrameMirror.prototype.receiver = function() {
return MakeMirror(this.details_.receiver());
};
FrameMirror.prototype.isConstructCall = function() {
return this.details_.isConstructCall();
};
FrameMirror.prototype.isAtReturn = function() {
return this.details_.isAtReturn();
};
FrameMirror.prototype.isDebuggerFrame = function() {
return this.details_.isDebuggerFrame();
};
FrameMirror.prototype.isOptimizedFrame = function() {
return this.details_.isOptimizedFrame();
};
FrameMirror.prototype.isInlinedFrame = function() {
return this.details_.isInlinedFrame();
};
FrameMirror.prototype.inlinedFrameIndex = function() {
return this.details_.inlinedFrameIndex();
};
FrameMirror.prototype.argumentCount = function() {
return this.details_.argumentCount();
};
FrameMirror.prototype.argumentName = function(index) {
return this.details_.argumentName(index);
};
FrameMirror.prototype.argumentValue = function(index) {
return MakeMirror(this.details_.argumentValue(index));
};
FrameMirror.prototype.localCount = function() {
return this.details_.localCount();
};
FrameMirror.prototype.localName = function(index) {
return this.details_.localName(index);
};
FrameMirror.prototype.localValue = function(index) {
return MakeMirror(this.details_.localValue(index));
};
FrameMirror.prototype.returnValue = function() {
return MakeMirror(this.details_.returnValue());
};
FrameMirror.prototype.sourcePosition = function() {
return this.details_.sourcePosition();
};
FrameMirror.prototype.sourceLocation = function() {
var func = this.func();
if (func.resolved()) {
var script = func.script();
if (script) {
return script.locationFromPosition(this.sourcePosition(), true);
}
}
};
FrameMirror.prototype.sourceLine = function() {
var location = this.sourceLocation();
if (location) {
return location.line;
}
};
FrameMirror.prototype.sourceColumn = function() {
var location = this.sourceLocation();
if (location) {
return location.column;
}
};
FrameMirror.prototype.sourceLineText = function() {
var location = this.sourceLocation();
if (location) {
return location.sourceText();
}
};
FrameMirror.prototype.scopeCount = function() {
return this.details_.scopeCount();
};
FrameMirror.prototype.scope = function(index) {
return new ScopeMirror(this, UNDEFINED, index);
};
FrameMirror.prototype.allScopes = function(opt_ignore_nested_scopes) {
var scopeDetails = %GetAllScopesDetails(this.break_id_,
this.details_.frameId(),
this.details_.inlinedFrameIndex(),
!!opt_ignore_nested_scopes);
var result = [];
for (var i = 0; i < scopeDetails.length; ++i) {
result.push(new ScopeMirror(this, UNDEFINED, i, scopeDetails[i]));
}
return result;
};
FrameMirror.prototype.stepInPositions = function() {
var script = this.func().script();
var funcOffset = this.func().sourcePosition_();
var stepInRaw = this.details_.stepInPositionsImpl();
var result = [];
if (stepInRaw) {
for (var i = 0; i < stepInRaw.length; i++) {
var posStruct = {};
var offset = script.locationFromPosition(funcOffset + stepInRaw[i],
true);
serializeLocationFields(offset, posStruct);
var item = {
position: posStruct
};
result.push(item);
}
}
return result;
};
FrameMirror.prototype.evaluate = function(source, disable_break,
opt_context_object) {
return MakeMirror(%DebugEvaluate(this.break_id_,
this.details_.frameId(),
this.details_.inlinedFrameIndex(),
source,
Boolean(disable_break),
opt_context_object));
};
FrameMirror.prototype.invocationText = function() {
// Format frame invoaction (receiver, function and arguments).
var result = '';
var func = this.func();
var receiver = this.receiver();
if (this.isConstructCall()) {
// For constructor frames display new followed by the function name.
result += 'new ';
result += func.name() ? func.name() : '[anonymous]';
} else if (this.isDebuggerFrame()) {
result += '[debugger]';
} else {
// If the receiver has a className which is 'global' don't display it.
var display_receiver =
!receiver.className || (receiver.className() != 'global');
if (display_receiver) {
result += receiver.toText();
}
// Try to find the function as a property in the receiver. Include the
// prototype chain in the lookup.
var property = GetUndefinedMirror();
if (receiver.isObject()) {
for (var r = receiver;
!r.isNull() && property.isUndefined();
r = r.protoObject()) {
property = r.lookupProperty(func);
}
}
if (!property.isUndefined()) {
// The function invoked was found on the receiver. Use the property name
// for the backtrace.
if (!property.isIndexed()) {
if (display_receiver) {
result += '.';
}
result += property.name();
} else {
result += '[';
result += property.name();
result += ']';
}
// Also known as - if the name in the function doesn't match the name
// under which it was looked up.
if (func.name() && func.name() != property.name()) {
result += '(aka ' + func.name() + ')';
}
} else {
// The function invoked was not found on the receiver. Use the function
// name if available for the backtrace.
if (display_receiver) {
result += '.';
}
result += func.name() ? func.name() : '[anonymous]';
}
}
// Render arguments for normal frames.
if (!this.isDebuggerFrame()) {
result += '(';
for (var i = 0; i < this.argumentCount(); i++) {
if (i != 0) result += ', ';
if (this.argumentName(i)) {
result += this.argumentName(i);
result += '=';
}
result += this.argumentValue(i).toText();
}
result += ')';
}
if (this.isAtReturn()) {
result += ' returning ';
result += this.returnValue().toText();
}
return result;
};
FrameMirror.prototype.sourceAndPositionText = function() {
// Format source and position.
var result = '';
var func = this.func();
if (func.resolved()) {
var script = func.script();
if (script) {
if (script.name()) {
result += script.name();
} else {
result += '[unnamed]';
}
if (!this.isDebuggerFrame()) {
var location = this.sourceLocation();
result += ' line ';
result += !IS_UNDEFINED(location) ? (location.line + 1) : '?';
result += ' column ';
result += !IS_UNDEFINED(location) ? (location.column + 1) : '?';
if (!IS_UNDEFINED(this.sourcePosition())) {
result += ' (position ' + (this.sourcePosition() + 1) + ')';
}
}
} else {
result += '[no source]';
}
} else {
result += '[unresolved]';
}
return result;
};
FrameMirror.prototype.localsText = function() {
// Format local variables.
var result = '';
var locals_count = this.localCount();
if (locals_count > 0) {
for (var i = 0; i < locals_count; ++i) {
result += ' var ';
result += this.localName(i);
result += ' = ';
result += this.localValue(i).toText();
if (i < locals_count - 1) result += '\n';
}
}
return result;
};
FrameMirror.prototype.restart = function() {
var result = %LiveEditRestartFrame(this.break_id_, this.index_);
if (IS_UNDEFINED(result)) {
result = "Failed to find requested frame";
}
return result;
};
FrameMirror.prototype.toText = function(opt_locals) {
var result = '';
result += '#' + (this.index() <= 9 ? '0' : '') + this.index();
result += ' ';
result += this.invocationText();
result += ' ';
result += this.sourceAndPositionText();
if (opt_locals) {
result += '\n';
result += this.localsText();
}
return result;
};
var kScopeDetailsTypeIndex = 0;
var kScopeDetailsObjectIndex = 1;
function ScopeDetails(frame, fun, index, opt_details) {
if (frame) {
this.break_id_ = frame.break_id_;
this.details_ = opt_details ||
%GetScopeDetails(frame.break_id_,
frame.details_.frameId(),
frame.details_.inlinedFrameIndex(),
index);
this.frame_id_ = frame.details_.frameId();
this.inlined_frame_id_ = frame.details_.inlinedFrameIndex();
} else {
this.details_ = opt_details || %GetFunctionScopeDetails(fun.value(), index);
this.fun_value_ = fun.value();
this.break_id_ = undefined;
}
this.index_ = index;
}
ScopeDetails.prototype.type = function() {
if (!IS_UNDEFINED(this.break_id_)) {
%CheckExecutionState(this.break_id_);
}
return this.details_[kScopeDetailsTypeIndex];
};
ScopeDetails.prototype.object = function() {
if (!IS_UNDEFINED(this.break_id_)) {
%CheckExecutionState(this.break_id_);
}
return this.details_[kScopeDetailsObjectIndex];
};
ScopeDetails.prototype.setVariableValueImpl = function(name, new_value) {
var raw_res;
if (!IS_UNDEFINED(this.break_id_)) {
%CheckExecutionState(this.break_id_);
raw_res = %SetScopeVariableValue(this.break_id_, this.frame_id_,
this.inlined_frame_id_, this.index_, name, new_value);
} else {
raw_res = %SetScopeVariableValue(this.fun_value_, null, null, this.index_,
name, new_value);
}
if (!raw_res) {
throw new Error("Failed to set variable value");
}
};
/**
* Mirror object for scope of frame or function. Either frame or function must
* be specified.
* @param {FrameMirror} frame The frame this scope is a part of
* @param {FunctionMirror} function The function this scope is a part of
* @param {number} index The scope index in the frame
* @param {Array=} opt_details Raw scope details data
* @constructor
* @extends Mirror
*/
function ScopeMirror(frame, function, index, opt_details) {
%_CallFunction(this, SCOPE_TYPE, Mirror);
if (frame) {
this.frame_index_ = frame.index_;
} else {
this.frame_index_ = undefined;
}
this.scope_index_ = index;
this.details_ = new ScopeDetails(frame, function, index, opt_details);
}
inherits(ScopeMirror, Mirror);
ScopeMirror.prototype.details = function() {
return this.details_;
};
ScopeMirror.prototype.frameIndex = function() {
return this.frame_index_;
};
ScopeMirror.prototype.scopeIndex = function() {
return this.scope_index_;
};
ScopeMirror.prototype.scopeType = function() {
return this.details_.type();
};
ScopeMirror.prototype.scopeObject = function() {
// For local and closure scopes create a transient mirror as these objects are
// created on the fly materializing the local or closure scopes and
// therefore will not preserve identity.
var transient = this.scopeType() == ScopeType.Local ||
this.scopeType() == ScopeType.Closure;
return MakeMirror(this.details_.object(), transient);
};
ScopeMirror.prototype.setVariableValue = function(name, new_value) {
this.details_.setVariableValueImpl(name, new_value);
};
/**
* Mirror object for script source.
* @param {Script} script The script object
* @constructor
* @extends Mirror
*/
function ScriptMirror(script) {
%_CallFunction(this, SCRIPT_TYPE, Mirror);
this.script_ = script;
this.context_ = new ContextMirror(script.context_data);
this.allocateHandle_();
}
inherits(ScriptMirror, Mirror);
ScriptMirror.prototype.value = function() {
return this.script_;
};
ScriptMirror.prototype.name = function() {
return this.script_.name || this.script_.nameOrSourceURL();
};
ScriptMirror.prototype.id = function() {
return this.script_.id;
};
ScriptMirror.prototype.source = function() {
return this.script_.source;
};
ScriptMirror.prototype.setSource = function(source) {
%DebugSetScriptSource(this.script_, source);
};
ScriptMirror.prototype.lineOffset = function() {
return this.script_.line_offset;
};
ScriptMirror.prototype.columnOffset = function() {
return this.script_.column_offset;
};
ScriptMirror.prototype.data = function() {
return this.script_.data;
};
ScriptMirror.prototype.scriptType = function() {
return this.script_.type;
};
ScriptMirror.prototype.compilationType = function() {
return this.script_.compilation_type;
};
ScriptMirror.prototype.lineCount = function() {
return this.script_.lineCount();
};
ScriptMirror.prototype.locationFromPosition = function(
position, include_resource_offset) {
return this.script_.locationFromPosition(position, include_resource_offset);
};
ScriptMirror.prototype.sourceSlice = function (opt_from_line, opt_to_line) {
return this.script_.sourceSlice(opt_from_line, opt_to_line);
};
ScriptMirror.prototype.context = function() {
return this.context_;
};
ScriptMirror.prototype.evalFromScript = function() {
return MakeMirror(this.script_.eval_from_script);
};
ScriptMirror.prototype.evalFromFunctionName = function() {
return MakeMirror(this.script_.eval_from_function_name);
};
ScriptMirror.prototype.evalFromLocation = function() {
var eval_from_script = this.evalFromScript();
if (!eval_from_script.isUndefined()) {
var position = this.script_.eval_from_script_position;
return eval_from_script.locationFromPosition(position, true);
}
};
ScriptMirror.prototype.toText = function() {
var result = '';
result += this.name();
result += ' (lines: ';
if (this.lineOffset() > 0) {
result += this.lineOffset();
result += '-';
result += this.lineOffset() + this.lineCount() - 1;
} else {
result += this.lineCount();
}
result += ')';
return result;
};
/**
* Mirror object for context.
* @param {Object} data The context data
* @constructor
* @extends Mirror
*/
function ContextMirror(data) {
%_CallFunction(this, CONTEXT_TYPE, Mirror);
this.data_ = data;
this.allocateHandle_();
}
inherits(ContextMirror, Mirror);
ContextMirror.prototype.data = function() {
return this.data_;
};
/**
* Returns a mirror serializer
*
* @param {boolean} details Set to true to include details
* @param {Object} options Options comtrolling the serialization
* The following options can be set:
* includeSource: include ths full source of scripts
* @returns {MirrorSerializer} mirror serializer
*/
function MakeMirrorSerializer(details, options) {
return new JSONProtocolSerializer(details, options);
}
/**
* Object for serializing a mirror objects and its direct references.
* @param {boolean} details Indicates whether to include details for the mirror
* serialized
* @constructor
*/
function JSONProtocolSerializer(details, options) {
this.details_ = details;
this.options_ = options;
this.mirrors_ = [ ];
}
/**
* Returns a serialization of an object reference. The referenced object are
* added to the serialization state.
*
* @param {Mirror} mirror The mirror to serialize
* @returns {String} JSON serialization
*/
JSONProtocolSerializer.prototype.serializeReference = function(mirror) {
return this.serialize_(mirror, true, true);
};
/**
* Returns a serialization of an object value. The referenced objects are
* added to the serialization state.
*
* @param {Mirror} mirror The mirror to serialize
* @returns {String} JSON serialization
*/
JSONProtocolSerializer.prototype.serializeValue = function(mirror) {
var json = this.serialize_(mirror, false, true);
return json;
};
/**
* Returns a serialization of all the objects referenced.
*
* @param {Mirror} mirror The mirror to serialize.
* @returns {Array.<Object>} Array of the referenced objects converted to
* protcol objects.
*/
JSONProtocolSerializer.prototype.serializeReferencedObjects = function() {
// Collect the protocol representation of the referenced objects in an array.
var content = [];
// Get the number of referenced objects.
var count = this.mirrors_.length;
for (var i = 0; i < count; i++) {
content.push(this.serialize_(this.mirrors_[i], false, false));
}
return content;
};
JSONProtocolSerializer.prototype.includeSource_ = function() {
return this.options_ && this.options_.includeSource;
};
JSONProtocolSerializer.prototype.inlineRefs_ = function() {
return this.options_ && this.options_.inlineRefs;
};
JSONProtocolSerializer.prototype.maxStringLength_ = function() {
if (IS_UNDEFINED(this.options_) ||
IS_UNDEFINED(this.options_.maxStringLength)) {
return kMaxProtocolStringLength;
}
return this.options_.maxStringLength;
};
JSONProtocolSerializer.prototype.add_ = function(mirror) {
// If this mirror is already in the list just return.
for (var i = 0; i < this.mirrors_.length; i++) {
if (this.mirrors_[i] === mirror) {
return;
}
}
// Add the mirror to the list of mirrors to be serialized.
this.mirrors_.push(mirror);
};
/**
* Formats mirror object to protocol reference object with some data that can
* be used to display the value in debugger.
* @param {Mirror} mirror Mirror to serialize.
* @return {Object} Protocol reference object.
*/
JSONProtocolSerializer.prototype.serializeReferenceWithDisplayData_ =
function(mirror) {
var o = {};
o.ref = mirror.handle();
o.type = mirror.type();
switch (mirror.type()) {
case UNDEFINED_TYPE:
case NULL_TYPE:
case BOOLEAN_TYPE:
case NUMBER_TYPE:
o.value = mirror.value();
break;
case STRING_TYPE:
o.value = mirror.getTruncatedValue(this.maxStringLength_());
break;
case SYMBOL_TYPE:
o.description = mirror.description();
break;
case FUNCTION_TYPE:
o.name = mirror.name();
o.inferredName = mirror.inferredName();
if (mirror.script()) {
o.scriptId = mirror.script().id();
}
break;
case ERROR_TYPE:
case REGEXP_TYPE:
o.value = mirror.toText();
break;
case OBJECT_TYPE:
o.className = mirror.className();
break;
}
return o;
};
JSONProtocolSerializer.prototype.serialize_ = function(mirror, reference,
details) {
// If serializing a reference to a mirror just return the reference and add
// the mirror to the referenced mirrors.
if (reference &&
(mirror.isValue() || mirror.isScript() || mirror.isContext())) {
if (this.inlineRefs_() && mirror.isValue()) {
return this.serializeReferenceWithDisplayData_(mirror);
} else {
this.add_(mirror);
return {'ref' : mirror.handle()};
}
}
// Collect the JSON property/value pairs.
var content = {};
// Add the mirror handle.
if (mirror.isValue() || mirror.isScript() || mirror.isContext()) {
content.handle = mirror.handle();
}
// Always add the type.
content.type = mirror.type();
switch (mirror.type()) {
case UNDEFINED_TYPE:
case NULL_TYPE:
// Undefined and null are represented just by their type.
break;
case BOOLEAN_TYPE:
// Boolean values are simply represented by their value.
content.value = mirror.value();
break;
case NUMBER_TYPE:
// Number values are simply represented by their value.
content.value = NumberToJSON_(mirror.value());
break;
case STRING_TYPE:
// String values might have their value cropped to keep down size.
if (this.maxStringLength_() != -1 &&
mirror.length() > this.maxStringLength_()) {
var str = mirror.getTruncatedValue(this.maxStringLength_());
content.value = str;
content.fromIndex = 0;
content.toIndex = this.maxStringLength_();
} else {
content.value = mirror.value();
}
content.length = mirror.length();
break;
case SYMBOL_TYPE:
content.description = mirror.description();
break;
case OBJECT_TYPE:
case FUNCTION_TYPE:
case ERROR_TYPE:
case REGEXP_TYPE:
case PROMISE_TYPE:
case GENERATOR_TYPE:
// Add object representation.
this.serializeObject_(mirror, content, details);
break;
case PROPERTY_TYPE:
case INTERNAL_PROPERTY_TYPE:
throw new Error('PropertyMirror cannot be serialized independently');
break;
case FRAME_TYPE:
// Add object representation.
this.serializeFrame_(mirror, content);
break;
case SCOPE_TYPE:
// Add object representation.
this.serializeScope_(mirror, content);
break;
case SCRIPT_TYPE:
// Script is represented by id, name and source attributes.
if (mirror.name()) {
content.name = mirror.name();
}
content.id = mirror.id();
content.lineOffset = mirror.lineOffset();
content.columnOffset = mirror.columnOffset();
content.lineCount = mirror.lineCount();
if (mirror.data()) {
content.data = mirror.data();
}
if (this.includeSource_()) {
content.source = mirror.source();
} else {
var sourceStart = mirror.source().substring(0, 80);
content.sourceStart = sourceStart;
}
content.sourceLength = mirror.source().length;
content.scriptType = mirror.scriptType();
content.compilationType = mirror.compilationType();
// For compilation type eval emit information on the script from which
// eval was called if a script is present.
if (mirror.compilationType() == 1 &&
mirror.evalFromScript()) {
content.evalFromScript =
this.serializeReference(mirror.evalFromScript());
var evalFromLocation = mirror.evalFromLocation();
if (evalFromLocation) {
content.evalFromLocation = { line: evalFromLocation.line,
column: evalFromLocation.column };
}
if (mirror.evalFromFunctionName()) {
content.evalFromFunctionName = mirror.evalFromFunctionName();
}
}
if (mirror.context()) {
content.context = this.serializeReference(mirror.context());
}
break;
case CONTEXT_TYPE:
content.data = mirror.data();
break;
}
// Always add the text representation.
content.text = mirror.toText();
// Create and return the JSON string.
return content;
};
/**
* Serialize object information to the following JSON format.
*
* {"className":"<class name>",
* "constructorFunction":{"ref":<number>},
* "protoObject":{"ref":<number>},
* "prototypeObject":{"ref":<number>},
* "namedInterceptor":<boolean>,
* "indexedInterceptor":<boolean>,
* "properties":[<properties>],
* "internalProperties":[<internal properties>]}
*/
JSONProtocolSerializer.prototype.serializeObject_ = function(mirror, content,
details) {
// Add general object properties.
content.className = mirror.className();
content.constructorFunction =
this.serializeReference(mirror.constructorFunction());
content.protoObject = this.serializeReference(mirror.protoObject());
content.prototypeObject = this.serializeReference(mirror.prototypeObject());
// Add flags to indicate whether there are interceptors.
if (mirror.hasNamedInterceptor()) {
content.namedInterceptor = true;
}
if (mirror.hasIndexedInterceptor()) {
content.indexedInterceptor = true;
}
if (mirror.isFunction()) {
// Add function specific properties.
content.name = mirror.name();
if (!IS_UNDEFINED(mirror.inferredName())) {
content.inferredName = mirror.inferredName();
}
content.resolved = mirror.resolved();
if (mirror.resolved()) {
content.source = mirror.source();
}
if (mirror.script()) {
content.script = this.serializeReference(mirror.script());
content.scriptId = mirror.script().id();
serializeLocationFields(mirror.sourceLocation(), content);
}
content.scopes = [];
for (var i = 0; i < mirror.scopeCount(); i++) {
var scope = mirror.scope(i);
content.scopes.push({
type: scope.scopeType(),
index: i
});
}
}
if (mirror.isGenerator()) {
// Add generator specific properties.
// Either 'running', 'closed', or 'suspended'.
content.status = mirror.status();
content.func = this.serializeReference(mirror.func())
content.receiver = this.serializeReference(mirror.receiver())
// If the generator is suspended, the content add line/column properties.
serializeLocationFields(mirror.sourceLocation(), content);
// TODO(wingo): Also serialize a reference to the context (scope chain).
}
if (mirror.isDate()) {
// Add date specific properties.
content.value = mirror.value();
}
if (mirror.isPromise()) {
// Add promise specific properties.
content.status = mirror.status();
content.promiseValue = this.serializeReference(mirror.promiseValue());
}
// Add actual properties - named properties followed by indexed properties.
var propertyNames = mirror.propertyNames(PropertyKind.Named);
var propertyIndexes = mirror.propertyNames(PropertyKind.Indexed);
var p = new Array(propertyNames.length + propertyIndexes.length);
for (var i = 0; i < propertyNames.length; i++) {
var propertyMirror = mirror.property(propertyNames[i]);
p[i] = this.serializeProperty_(propertyMirror);
if (details) {
this.add_(propertyMirror.value());
}
}
for (var i = 0; i < propertyIndexes.length; i++) {
var propertyMirror = mirror.property(propertyIndexes[i]);
p[propertyNames.length + i] = this.serializeProperty_(propertyMirror);
if (details) {
this.add_(propertyMirror.value());
}
}
content.properties = p;
var internalProperties = mirror.internalProperties();
if (internalProperties.length > 0) {
var ip = [];
for (var i = 0; i < internalProperties.length; i++) {
ip.push(this.serializeInternalProperty_(internalProperties[i]));
}
content.internalProperties = ip;
}
};
/**
* Serialize location information to the following JSON format:
*
* "position":"<position>",
* "line":"<line>",
* "column":"<column>",
*
* @param {SourceLocation} location The location to serialize, may be undefined.
*/
function serializeLocationFields (location, content) {
if (!location) {
return;
}
content.position = location.position;
var line = location.line;
if (!IS_UNDEFINED(line)) {
content.line = line;
}
var column = location.column;
if (!IS_UNDEFINED(column)) {
content.column = column;
}
}
/**
* Serialize property information to the following JSON format for building the
* array of properties.
*
* {"name":"<property name>",
* "attributes":<number>,
* "propertyType":<number>,
* "ref":<number>}
*
* If the attribute for the property is PropertyAttribute.None it is not added.
* If the propertyType for the property is PropertyType.Normal it is not added.
* Here are a couple of examples.
*
* {"name":"hello","ref":1}
* {"name":"length","attributes":7,"propertyType":3,"ref":2}
*
* @param {PropertyMirror} propertyMirror The property to serialize.
* @returns {Object} Protocol object representing the property.
*/
JSONProtocolSerializer.prototype.serializeProperty_ = function(propertyMirror) {
var result = {};
result.name = propertyMirror.name();
var propertyValue = propertyMirror.value();
if (this.inlineRefs_() && propertyValue.isValue()) {
result.value = this.serializeReferenceWithDisplayData_(propertyValue);
} else {
if (propertyMirror.attributes() != PropertyAttribute.None) {
result.attributes = propertyMirror.attributes();
}
if (propertyMirror.propertyType() != PropertyType.Normal) {
result.propertyType = propertyMirror.propertyType();
}
result.ref = propertyValue.handle();
}
return result;
};
/**
* Serialize internal property information to the following JSON format for
* building the array of properties.
*
* {"name":"<property name>",
* "ref":<number>}
*
* {"name":"[[BoundThis]]","ref":117}
*
* @param {InternalPropertyMirror} propertyMirror The property to serialize.
* @returns {Object} Protocol object representing the property.
*/
JSONProtocolSerializer.prototype.serializeInternalProperty_ =
function(propertyMirror) {
var result = {};
result.name = propertyMirror.name();
var propertyValue = propertyMirror.value();
if (this.inlineRefs_() && propertyValue.isValue()) {
result.value = this.serializeReferenceWithDisplayData_(propertyValue);
} else {
result.ref = propertyValue.handle();
}
return result;
};
JSONProtocolSerializer.prototype.serializeFrame_ = function(mirror, content) {
content.index = mirror.index();
content.receiver = this.serializeReference(mirror.receiver());
var func = mirror.func();
content.func = this.serializeReference(func);
var script = func.script();
if (script) {
content.script = this.serializeReference(script);
}
content.constructCall = mirror.isConstructCall();
content.atReturn = mirror.isAtReturn();
if (mirror.isAtReturn()) {
content.returnValue = this.serializeReference(mirror.returnValue());
}
content.debuggerFrame = mirror.isDebuggerFrame();
var x = new Array(mirror.argumentCount());
for (var i = 0; i < mirror.argumentCount(); i++) {
var arg = {};
var argument_name = mirror.argumentName(i);
if (argument_name) {
arg.name = argument_name;
}
arg.value = this.serializeReference(mirror.argumentValue(i));
x[i] = arg;
}
content.arguments = x;
var x = new Array(mirror.localCount());
for (var i = 0; i < mirror.localCount(); i++) {
var local = {};
local.name = mirror.localName(i);
local.value = this.serializeReference(mirror.localValue(i));
x[i] = local;
}
content.locals = x;
serializeLocationFields(mirror.sourceLocation(), content);
var source_line_text = mirror.sourceLineText();
if (!IS_UNDEFINED(source_line_text)) {
content.sourceLineText = source_line_text;
}
content.scopes = [];
for (var i = 0; i < mirror.scopeCount(); i++) {
var scope = mirror.scope(i);
content.scopes.push({
type: scope.scopeType(),
index: i
});
}
};
JSONProtocolSerializer.prototype.serializeScope_ = function(mirror, content) {
content.index = mirror.scopeIndex();
content.frameIndex = mirror.frameIndex();
content.type = mirror.scopeType();
content.object = this.inlineRefs_() ?
this.serializeValue(mirror.scopeObject()) :
this.serializeReference(mirror.scopeObject());
};
/**
* Convert a number to a protocol value. For all finite numbers the number
* itself is returned. For non finite numbers NaN, Infinite and
* -Infinite the string representation "NaN", "Infinite" or "-Infinite"
* (not including the quotes) is returned.
*
* @param {number} value The number value to convert to a protocol value.
* @returns {number|string} Protocol value.
*/
function NumberToJSON_(value) {
if (isNaN(value)) {
return 'NaN';
}
if (!NUMBER_IS_FINITE(value)) {
if (value > 0) {
return 'Infinity';
} else {
return '-Infinity';
}
}
return value;
}