Added the 'references' command to the debugger protocol to provide access to ...

src/d8.js

 // Copyright 2008 the V8 project authors. All rights reserved.
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions are
 // met:
 //
 //     * Redistributions of source code must retain the above copyright
 //       notice, this list of conditions and the following disclaimer.
 //     * Redistributions in binary form must reproduce the above
 //       copyright notice, this list of conditions and the following
 //       disclaimer in the documentation and/or other materials provided
@@ skipping 264 matching lines @@
       
     case 'print':
     case 'p':
       this.request_ = this.printCommandToJSONRequest_(args);
       break;
 
     case 'dir':
       this.request_ = this.dirCommandToJSONRequest_(args);
       break;
 
+    case 'references':
+      this.request_ = this.referencesCommandToJSONRequest_(args);
+      break;
+
+    case 'instances':
+      this.request_ = this.instancesCommandToJSONRequest_(args);
+      break;
+
     case 'source':
       this.request_ = this.sourceCommandToJSONRequest_(args);
       break;
       
     case 'scripts':
       this.request_ = this.scriptsCommandToJSONRequest_(args);
       break;
       
     case 'break':
     case 'b':
@@ skipping 61 matching lines @@
 DebugRequest.prototype.createRequest = function(command) {
   return new RequestPacket(command);
 };
 
 
 // Create a JSON request for the evaluation command.
 DebugRequest.prototype.makeEvaluateJSONRequest_ = function(expression) {
   // Check if the expression is a handle id in the form #<handle>#.
   var handle_match = expression.match(/^#([0-9]*)#$/);
   if (handle_match) {
-    // Build an evaluate request.
+    // Build a lookup request.
     var request = this.createRequest('lookup');
     request.arguments = {};
     request.arguments.handle = parseInt(handle_match[1]);
     return request.toJSONProtocol();
   } else {
     // Build an evaluate request.
     var request = this.createRequest('evaluate');
     request.arguments = {};
     request.arguments.expression = expression;
     return request.toJSONProtocol();
   }
 };
 
 
+// Create a JSON request for the references/instances command.
+DebugRequest.prototype.makeReferencesJSONRequest_ = function(handle, type) {
+  // Build a references request.
+  var handle_match = handle.match(/^#([0-9]*)#$/);
+  if (handle_match) {
+    var request = this.createRequest('references');
+    request.arguments = {};
+    request.arguments.type = type;
+    request.arguments.handle = parseInt(handle_match[1]);
+    return request.toJSONProtocol();
+  } else {
+    throw new Error('Invalid object id.');
+  }
+};
+
 
 // Create a JSON request for the continue command.
 DebugRequest.prototype.continueCommandToJSONRequest_ = function(args) {
   var request = this.createRequest('continue');
   return request.toJSONProtocol();
 };
 
 
 // Create a JSON request for the step command.
 DebugRequest.prototype.stepCommandToJSONRequest_ = function(args) {
@@ skipping 107 matching lines @@
 // Create a JSON request for the dir command.
 DebugRequest.prototype.dirCommandToJSONRequest_ = function(args) {
   // Build an evaluate request from the text command.
   if (args.length == 0) {
     throw new Error('Missing expression.');
   }
   return this.makeEvaluateJSONRequest_(args);
 };
 
 
+// Create a JSON request for the references command.
+DebugRequest.prototype.referencesCommandToJSONRequest_ = function(args) {
+  // Build an evaluate request from the text command.
+  if (args.length == 0) {
+    throw new Error('Missing object id.');
+  }
+  
+  return this.makeReferencesJSONRequest_(args, 'referencedBy');
+};
+
+
+// Create a JSON request for the instances command.
+DebugRequest.prototype.instancesCommandToJSONRequest_ = function(args) {
+  // Build an evaluate request from the text command.
+  if (args.length == 0) {
+    throw new Error('Missing object id.');
+  }
+  
+  // Build a references request.
+  return this.makeReferencesJSONRequest_(args, 'constructedBy');
+};
+
+
 // Create a JSON request for the source command.
 DebugRequest.prototype.sourceCommandToJSONRequest_ = function(args) {
   // Build a evaluate request from the text command.
   var request = this.createRequest('source');
 
   // Default is ten lines starting five lines before the current location.
   var from = Debug.State.currentSourceLine - 5;
   var lines = 10;
 
   // Parse the arguments.
@@ skipping 135 matching lines @@
   print('trace compile');
   print('help');
 }
 
 
 function formatHandleReference_(value) {
   return '#' + value.handle() + '#';
 }
 
 
+function formatObject_(value, include_properties) {
+  var result = '';
+  result += formatHandleReference_(value);
+  result += ', type: object'
+  result += ', constructor ';
+  var ctor = value.constructorFunctionValue();
+  result += formatHandleReference_(ctor);
+  result += ', __proto__ ';
+  var proto = value.protoObjectValue();
+  result += formatHandleReference_(proto);
+  result += ', ';
+  result += value.propertyCount();
+  result +=  ' properties.';
+  if (include_properties) {
+    result +=  '\n';
+    for (var i = 0; i < value.propertyCount(); i++) {
+      result += '  ';
+      result += value.propertyName(i);
+      result += ': ';
+      var property_value = value.propertyValue(i);
+      if (property_value && property_value.type()) {
+        result += property_value.type();
+      } else {
+        result += '<no type>';
+      }
+      result += ' ';
+      result += formatHandleReference_(property_value);
+      result += '\n';
+    }
+  }
+  return result;
+}
+
+
 // Convert a JSON response to text for display in a text based debugger.
 function DebugResponseDetails(json_response) {
   details = {text:'', running:false}
 
   try {
     // Convert the JSON string to an object.
     var response = new ProtocolPackage(json_response);
 
     if (!response.success()) {
       details.text = response.message();
@@ skipping 39 matching lines @@
         Debug.State.currentFrame = body.index;
         break;
         
       case 'evaluate':
       case 'lookup':
         if (last_cmd == 'p' || last_cmd == 'print') {
           details.text =  body.text;
         } else {
           var value = response.bodyValue();
           if (value.isObject()) {
-            result += formatHandleReference_(value);
-            result += ', type: object'
-            result += ', constructor ';
-            var ctor = value.constructorFunctionValue();
-            result += formatHandleReference_(ctor);
-            result += ', __proto__ ';
-            var proto = value.protoObjectValue();
-            result += formatHandleReference_(proto);
-            result += ', ';
-            result += value.propertyCount();
-            result +=  ' properties.\n';
-            for (var i = 0; i < value.propertyCount(); i++) {
-              result += '  ';
-              result += value.propertyName(i);
-              result += ': ';
-              var property_value = value.propertyValue(i);
-              if (property_value && property_value.type()) {
-                result += property_value.type();
-              } else {
-                result += '<no type>';
-              }
-              result += ' ';
-              result += formatHandleReference_(property_value);
-              result += '\n';
-            }
+            result += formatObject_(value, true);
           } else {
             result += 'type: ';
             result += value.type();
             if (!value.isUndefined() && !value.isNull()) {
               result += ', ';
               if (value.isString()) {
                 result += '"';
               }
               result += value.value();
               if (value.isString()) {
                 result += '"';
               }
             }
             result += '\n';
           }
         }
         details.text = result;
         break;
+
+      case 'references':
+        var count = body.length;
+        result += 'found ' + count + ' objects';
+        result += '\n';
+        for (var i = 0; i < count; i++) {
+          var value = response.bodyValue(i);
+          result += formatObject_(value, false);
+          result += '\n';
+        }
+        details.text = result;
+        break;
         
       case 'source':
         // Get the source from the response.
         var source = body.source;
         var from_line = body.fromLine + 1;
         var lines = source.split('\n');
         var maxdigits = 1 + Math.floor(log10(from_line + lines.length));
         if (maxdigits < 3) {
           maxdigits = 3;
         }
@@ skipping 133 matching lines @@
 ProtocolPackage.prototype.command = function() {
   return this.packet_.command;
 }
 
 
 ProtocolPackage.prototype.body = function() {
   return this.packet_.body;
 }
 
 
-ProtocolPackage.prototype.bodyValue = function() {
-  return new ProtocolValue(this.packet_.body, this);
+ProtocolPackage.prototype.bodyValue = function(index) {
+  if (IS_UNDEFINED(index)) {
+    return new ProtocolValue(this.packet_.body, this);
+  } else {
+    return new ProtocolValue(this.packet_.body[index], this);
+  }
 }
 
 
 ProtocolPackage.prototype.body = function() {
   return this.packet_.body;
 }
 
 
 ProtocolPackage.prototype.lookup = function(handle) {
   var value = this.refs_[handle];
@@ skipping 374 matching lines @@
       json += NumberToJSON_(elem);
     } else if (typeof(elem) === 'string')  {
       json += StringToJSON_(elem);
     } else {
       json += elem;
     }
   }
   json += ']';
   return json;
 }