Home | History | Annotate | Download | only in runtime
      1 // Copyright 2014 the V8 project authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #include "src/runtime/runtime-utils.h"
      6 
      7 #include "src/arguments.h"
      8 #include "src/compiler.h"
      9 #include "src/debug/debug-coverage.h"
     10 #include "src/debug/debug-evaluate.h"
     11 #include "src/debug/debug-frames.h"
     12 #include "src/debug/debug-scopes.h"
     13 #include "src/debug/debug.h"
     14 #include "src/debug/liveedit.h"
     15 #include "src/frames-inl.h"
     16 #include "src/globals.h"
     17 #include "src/interpreter/bytecodes.h"
     18 #include "src/interpreter/interpreter.h"
     19 #include "src/isolate-inl.h"
     20 #include "src/runtime/runtime.h"
     21 #include "src/wasm/wasm-module.h"
     22 #include "src/wasm/wasm-objects.h"
     23 
     24 namespace v8 {
     25 namespace internal {
     26 
     27 RUNTIME_FUNCTION(Runtime_DebugBreak) {
     28   SealHandleScope shs(isolate);
     29   DCHECK_EQ(1, args.length());
     30   CONVERT_ARG_HANDLE_CHECKED(Object, value, 0);
     31   HandleScope scope(isolate);
     32   ReturnValueScope result_scope(isolate->debug());
     33   isolate->debug()->set_return_value(*value);
     34 
     35   // Get the top-most JavaScript frame.
     36   JavaScriptFrameIterator it(isolate);
     37   isolate->debug()->Break(it.frame());
     38   return isolate->debug()->return_value();
     39 }
     40 
     41 RUNTIME_FUNCTION(Runtime_DebugBreakOnBytecode) {
     42   SealHandleScope shs(isolate);
     43   DCHECK_EQ(1, args.length());
     44   CONVERT_ARG_HANDLE_CHECKED(Object, value, 0);
     45   HandleScope scope(isolate);
     46   ReturnValueScope result_scope(isolate->debug());
     47   isolate->debug()->set_return_value(*value);
     48 
     49   // Get the top-most JavaScript frame.
     50   JavaScriptFrameIterator it(isolate);
     51   isolate->debug()->Break(it.frame());
     52 
     53   // Return the handler from the original bytecode array.
     54   DCHECK(it.frame()->is_interpreted());
     55   InterpretedFrame* interpreted_frame =
     56       reinterpret_cast<InterpretedFrame*>(it.frame());
     57   SharedFunctionInfo* shared = interpreted_frame->function()->shared();
     58   BytecodeArray* bytecode_array = shared->bytecode_array();
     59   int bytecode_offset = interpreted_frame->GetBytecodeOffset();
     60   interpreter::Bytecode bytecode =
     61       interpreter::Bytecodes::FromByte(bytecode_array->get(bytecode_offset));
     62   return isolate->interpreter()->GetBytecodeHandler(
     63       bytecode, interpreter::OperandScale::kSingle);
     64 }
     65 
     66 
     67 RUNTIME_FUNCTION(Runtime_HandleDebuggerStatement) {
     68   SealHandleScope shs(isolate);
     69   DCHECK_EQ(0, args.length());
     70   if (isolate->debug()->break_points_active()) {
     71     isolate->debug()->HandleDebugBreak();
     72   }
     73   return isolate->heap()->undefined_value();
     74 }
     75 
     76 
     77 // Adds a JavaScript function as a debug event listener.
     78 // args[0]: debug event listener function to set or null or undefined for
     79 //          clearing the event listener function
     80 // args[1]: object supplied during callback
     81 RUNTIME_FUNCTION(Runtime_SetDebugEventListener) {
     82   SealHandleScope shs(isolate);
     83   DCHECK_EQ(2, args.length());
     84   CHECK(args[0]->IsJSFunction() || args[0]->IsNullOrUndefined(isolate));
     85   CONVERT_ARG_HANDLE_CHECKED(Object, callback, 0);
     86   CONVERT_ARG_HANDLE_CHECKED(Object, data, 1);
     87   if (callback->IsJSFunction()) {
     88     JavaScriptDebugDelegate* delegate = new JavaScriptDebugDelegate(
     89         isolate, Handle<JSFunction>::cast(callback), data);
     90     isolate->debug()->SetDebugDelegate(delegate, true);
     91   } else {
     92     isolate->debug()->SetDebugDelegate(nullptr, false);
     93   }
     94   return isolate->heap()->undefined_value();
     95 }
     96 
     97 
     98 RUNTIME_FUNCTION(Runtime_ScheduleBreak) {
     99   SealHandleScope shs(isolate);
    100   DCHECK_EQ(0, args.length());
    101   isolate->stack_guard()->RequestDebugBreak();
    102   return isolate->heap()->undefined_value();
    103 }
    104 
    105 
    106 static Handle<Object> DebugGetProperty(LookupIterator* it,
    107                                        bool* has_caught = NULL) {
    108   for (; it->IsFound(); it->Next()) {
    109     switch (it->state()) {
    110       case LookupIterator::NOT_FOUND:
    111       case LookupIterator::TRANSITION:
    112         UNREACHABLE();
    113       case LookupIterator::ACCESS_CHECK:
    114         // Ignore access checks.
    115         break;
    116       case LookupIterator::INTEGER_INDEXED_EXOTIC:
    117       case LookupIterator::INTERCEPTOR:
    118       case LookupIterator::JSPROXY:
    119         return it->isolate()->factory()->undefined_value();
    120       case LookupIterator::ACCESSOR: {
    121         Handle<Object> accessors = it->GetAccessors();
    122         if (!accessors->IsAccessorInfo()) {
    123           return it->isolate()->factory()->undefined_value();
    124         }
    125         MaybeHandle<Object> maybe_result =
    126             JSObject::GetPropertyWithAccessor(it);
    127         Handle<Object> result;
    128         if (!maybe_result.ToHandle(&result)) {
    129           result = handle(it->isolate()->pending_exception(), it->isolate());
    130           it->isolate()->clear_pending_exception();
    131           if (has_caught != NULL) *has_caught = true;
    132         }
    133         return result;
    134       }
    135 
    136       case LookupIterator::DATA:
    137         return it->GetDataValue();
    138     }
    139   }
    140 
    141   return it->isolate()->factory()->undefined_value();
    142 }
    143 
    144 template <class IteratorType>
    145 static MaybeHandle<JSArray> GetIteratorInternalProperties(
    146     Isolate* isolate, Handle<IteratorType> object) {
    147   Factory* factory = isolate->factory();
    148   Handle<IteratorType> iterator = Handle<IteratorType>::cast(object);
    149   CHECK(iterator->kind()->IsSmi());
    150   const char* kind = NULL;
    151   switch (Smi::cast(iterator->kind())->value()) {
    152     case IteratorType::kKindKeys:
    153       kind = "keys";
    154       break;
    155     case IteratorType::kKindValues:
    156       kind = "values";
    157       break;
    158     case IteratorType::kKindEntries:
    159       kind = "entries";
    160       break;
    161     default:
    162       UNREACHABLE();
    163   }
    164 
    165   Handle<FixedArray> result = factory->NewFixedArray(2 * 3);
    166   Handle<String> has_more =
    167       factory->NewStringFromAsciiChecked("[[IteratorHasMore]]");
    168   result->set(0, *has_more);
    169   result->set(1, isolate->heap()->ToBoolean(iterator->HasMore()));
    170 
    171   Handle<String> index =
    172       factory->NewStringFromAsciiChecked("[[IteratorIndex]]");
    173   result->set(2, *index);
    174   result->set(3, iterator->index());
    175 
    176   Handle<String> iterator_kind =
    177       factory->NewStringFromAsciiChecked("[[IteratorKind]]");
    178   result->set(4, *iterator_kind);
    179   Handle<String> kind_str = factory->NewStringFromAsciiChecked(kind);
    180   result->set(5, *kind_str);
    181   return factory->NewJSArrayWithElements(result);
    182 }
    183 
    184 
    185 MaybeHandle<JSArray> Runtime::GetInternalProperties(Isolate* isolate,
    186                                                     Handle<Object> object) {
    187   Factory* factory = isolate->factory();
    188   if (object->IsJSBoundFunction()) {
    189     Handle<JSBoundFunction> function = Handle<JSBoundFunction>::cast(object);
    190 
    191     Handle<FixedArray> result = factory->NewFixedArray(2 * 3);
    192     Handle<String> target =
    193         factory->NewStringFromAsciiChecked("[[TargetFunction]]");
    194     result->set(0, *target);
    195     result->set(1, function->bound_target_function());
    196 
    197     Handle<String> bound_this =
    198         factory->NewStringFromAsciiChecked("[[BoundThis]]");
    199     result->set(2, *bound_this);
    200     result->set(3, function->bound_this());
    201 
    202     Handle<String> bound_args =
    203         factory->NewStringFromAsciiChecked("[[BoundArgs]]");
    204     result->set(4, *bound_args);
    205     Handle<FixedArray> bound_arguments =
    206         factory->CopyFixedArray(handle(function->bound_arguments(), isolate));
    207     Handle<JSArray> arguments_array =
    208         factory->NewJSArrayWithElements(bound_arguments);
    209     result->set(5, *arguments_array);
    210     return factory->NewJSArrayWithElements(result);
    211   } else if (object->IsJSMapIterator()) {
    212     Handle<JSMapIterator> iterator = Handle<JSMapIterator>::cast(object);
    213     return GetIteratorInternalProperties(isolate, iterator);
    214   } else if (object->IsJSSetIterator()) {
    215     Handle<JSSetIterator> iterator = Handle<JSSetIterator>::cast(object);
    216     return GetIteratorInternalProperties(isolate, iterator);
    217   } else if (object->IsJSGeneratorObject()) {
    218     Handle<JSGeneratorObject> generator =
    219         Handle<JSGeneratorObject>::cast(object);
    220 
    221     const char* status = "suspended";
    222     if (generator->is_closed()) {
    223       status = "closed";
    224     } else if (generator->is_executing()) {
    225       status = "running";
    226     } else {
    227       DCHECK(generator->is_suspended());
    228     }
    229 
    230     Handle<FixedArray> result = factory->NewFixedArray(2 * 3);
    231     Handle<String> generator_status =
    232         factory->NewStringFromAsciiChecked("[[GeneratorStatus]]");
    233     result->set(0, *generator_status);
    234     Handle<String> status_str = factory->NewStringFromAsciiChecked(status);
    235     result->set(1, *status_str);
    236 
    237     Handle<String> function =
    238         factory->NewStringFromAsciiChecked("[[GeneratorFunction]]");
    239     result->set(2, *function);
    240     result->set(3, generator->function());
    241 
    242     Handle<String> receiver =
    243         factory->NewStringFromAsciiChecked("[[GeneratorReceiver]]");
    244     result->set(4, *receiver);
    245     result->set(5, generator->receiver());
    246     return factory->NewJSArrayWithElements(result);
    247   } else if (object->IsJSPromise()) {
    248     Handle<JSPromise> promise = Handle<JSPromise>::cast(object);
    249     const char* status = JSPromise::Status(promise->status());
    250     Handle<FixedArray> result = factory->NewFixedArray(2 * 2);
    251     Handle<String> promise_status =
    252         factory->NewStringFromAsciiChecked("[[PromiseStatus]]");
    253     result->set(0, *promise_status);
    254     Handle<String> status_str = factory->NewStringFromAsciiChecked(status);
    255     result->set(1, *status_str);
    256 
    257     Handle<Object> value_obj(promise->result(), isolate);
    258     Handle<String> promise_value =
    259         factory->NewStringFromAsciiChecked("[[PromiseValue]]");
    260     result->set(2, *promise_value);
    261     result->set(3, *value_obj);
    262     return factory->NewJSArrayWithElements(result);
    263   } else if (object->IsJSProxy()) {
    264     Handle<JSProxy> js_proxy = Handle<JSProxy>::cast(object);
    265     Handle<FixedArray> result = factory->NewFixedArray(3 * 2);
    266 
    267     Handle<String> handler_str =
    268         factory->NewStringFromAsciiChecked("[[Handler]]");
    269     result->set(0, *handler_str);
    270     result->set(1, js_proxy->handler());
    271 
    272     Handle<String> target_str =
    273         factory->NewStringFromAsciiChecked("[[Target]]");
    274     result->set(2, *target_str);
    275     result->set(3, js_proxy->target());
    276 
    277     Handle<String> is_revoked_str =
    278         factory->NewStringFromAsciiChecked("[[IsRevoked]]");
    279     result->set(4, *is_revoked_str);
    280     result->set(5, isolate->heap()->ToBoolean(js_proxy->IsRevoked()));
    281     return factory->NewJSArrayWithElements(result);
    282   } else if (object->IsJSValue()) {
    283     Handle<JSValue> js_value = Handle<JSValue>::cast(object);
    284 
    285     Handle<FixedArray> result = factory->NewFixedArray(2);
    286     Handle<String> primitive_value =
    287         factory->NewStringFromAsciiChecked("[[PrimitiveValue]]");
    288     result->set(0, *primitive_value);
    289     result->set(1, js_value->value());
    290     return factory->NewJSArrayWithElements(result);
    291   }
    292   return factory->NewJSArray(0);
    293 }
    294 
    295 
    296 RUNTIME_FUNCTION(Runtime_DebugGetInternalProperties) {
    297   HandleScope scope(isolate);
    298   DCHECK_EQ(1, args.length());
    299   CONVERT_ARG_HANDLE_CHECKED(Object, obj, 0);
    300   RETURN_RESULT_OR_FAILURE(isolate,
    301                            Runtime::GetInternalProperties(isolate, obj));
    302 }
    303 
    304 
    305 // Get debugger related details for an object property, in the following format:
    306 // 0: Property value
    307 // 1: Property details
    308 // 2: Property value is exception
    309 // 3: Getter function if defined
    310 // 4: Setter function if defined
    311 // Items 2-4 are only filled if the property has either a getter or a setter.
    312 RUNTIME_FUNCTION(Runtime_DebugGetPropertyDetails) {
    313   HandleScope scope(isolate);
    314   DCHECK_EQ(2, args.length());
    315   CONVERT_ARG_HANDLE_CHECKED(JSObject, obj, 0);
    316   CONVERT_ARG_HANDLE_CHECKED(Object, name_obj, 1);
    317 
    318   // Convert the {name_obj} to a Name.
    319   Handle<Name> name;
    320   ASSIGN_RETURN_FAILURE_ON_EXCEPTION(isolate, name,
    321                                      Object::ToName(isolate, name_obj));
    322 
    323   // Make sure to set the current context to the context before the debugger was
    324   // entered (if the debugger is entered). The reason for switching context here
    325   // is that for some property lookups (accessors and interceptors) callbacks
    326   // into the embedding application can occour, and the embedding application
    327   // could have the assumption that its own native context is the current
    328   // context and not some internal debugger context.
    329   SaveContext save(isolate);
    330   if (isolate->debug()->in_debug_scope()) {
    331     isolate->set_context(*isolate->debug()->debugger_entry()->GetContext());
    332   }
    333 
    334   // Check if the name is trivially convertible to an index and get the element
    335   // if so.
    336   uint32_t index;
    337   // TODO(verwaest): Make sure DebugGetProperty can handle arrays, and remove
    338   // this special case.
    339   if (name->AsArrayIndex(&index)) {
    340     Handle<FixedArray> details = isolate->factory()->NewFixedArray(2);
    341     Handle<Object> element_or_char;
    342     ASSIGN_RETURN_FAILURE_ON_EXCEPTION(
    343         isolate, element_or_char, JSReceiver::GetElement(isolate, obj, index));
    344     details->set(0, *element_or_char);
    345     details->set(1, PropertyDetails::Empty().AsSmi());
    346     return *isolate->factory()->NewJSArrayWithElements(details);
    347   }
    348 
    349   LookupIterator it(obj, name, LookupIterator::OWN);
    350   bool has_caught = false;
    351   Handle<Object> value = DebugGetProperty(&it, &has_caught);
    352   if (!it.IsFound()) return isolate->heap()->undefined_value();
    353 
    354   Handle<Object> maybe_pair;
    355   if (it.state() == LookupIterator::ACCESSOR) {
    356     maybe_pair = it.GetAccessors();
    357   }
    358 
    359   // If the callback object is a fixed array then it contains JavaScript
    360   // getter and/or setter.
    361   bool has_js_accessors = !maybe_pair.is_null() && maybe_pair->IsAccessorPair();
    362   Handle<FixedArray> details =
    363       isolate->factory()->NewFixedArray(has_js_accessors ? 6 : 3);
    364   details->set(0, *value);
    365   // TODO(verwaest): Get rid of this random way of handling interceptors.
    366   PropertyDetails d = it.state() == LookupIterator::INTERCEPTOR
    367                           ? PropertyDetails::Empty()
    368                           : it.property_details();
    369   details->set(1, d.AsSmi());
    370   details->set(
    371       2, isolate->heap()->ToBoolean(it.state() == LookupIterator::INTERCEPTOR));
    372   if (has_js_accessors) {
    373     Handle<AccessorPair> accessors = Handle<AccessorPair>::cast(maybe_pair);
    374     details->set(3, isolate->heap()->ToBoolean(has_caught));
    375     Handle<Object> getter =
    376         AccessorPair::GetComponent(accessors, ACCESSOR_GETTER);
    377     Handle<Object> setter =
    378         AccessorPair::GetComponent(accessors, ACCESSOR_SETTER);
    379     details->set(4, *getter);
    380     details->set(5, *setter);
    381   }
    382 
    383   return *isolate->factory()->NewJSArrayWithElements(details);
    384 }
    385 
    386 
    387 RUNTIME_FUNCTION(Runtime_DebugGetProperty) {
    388   HandleScope scope(isolate);
    389 
    390   DCHECK_EQ(2, args.length());
    391 
    392   CONVERT_ARG_HANDLE_CHECKED(Object, obj, 0);
    393   CONVERT_ARG_HANDLE_CHECKED(Name, name, 1);
    394 
    395   LookupIterator it(obj, name);
    396   return *DebugGetProperty(&it);
    397 }
    398 
    399 // Return the property kind calculated from the property details.
    400 // args[0]: smi with property details.
    401 RUNTIME_FUNCTION(Runtime_DebugPropertyKindFromDetails) {
    402   SealHandleScope shs(isolate);
    403   DCHECK_EQ(1, args.length());
    404   CONVERT_PROPERTY_DETAILS_CHECKED(details, 0);
    405   return Smi::FromInt(static_cast<int>(details.kind()));
    406 }
    407 
    408 
    409 // Return the property attribute calculated from the property details.
    410 // args[0]: smi with property details.
    411 RUNTIME_FUNCTION(Runtime_DebugPropertyAttributesFromDetails) {
    412   SealHandleScope shs(isolate);
    413   DCHECK_EQ(1, args.length());
    414   CONVERT_PROPERTY_DETAILS_CHECKED(details, 0);
    415   return Smi::FromInt(static_cast<int>(details.attributes()));
    416 }
    417 
    418 
    419 RUNTIME_FUNCTION(Runtime_CheckExecutionState) {
    420   SealHandleScope shs(isolate);
    421   DCHECK_EQ(1, args.length());
    422   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
    423   CHECK(isolate->debug()->CheckExecutionState(break_id));
    424   return isolate->heap()->true_value();
    425 }
    426 
    427 
    428 RUNTIME_FUNCTION(Runtime_GetFrameCount) {
    429   HandleScope scope(isolate);
    430   DCHECK_EQ(1, args.length());
    431   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
    432   CHECK(isolate->debug()->CheckExecutionState(break_id));
    433 
    434   // Count all frames which are relevant to debugging stack trace.
    435   int n = 0;
    436   StackFrame::Id id = isolate->debug()->break_frame_id();
    437   if (id == StackFrame::NO_ID) {
    438     // If there is no JavaScript stack frame count is 0.
    439     return Smi::kZero;
    440   }
    441 
    442   List<FrameSummary> frames(FLAG_max_inlining_levels + 1);
    443   for (StackTraceFrameIterator it(isolate, id); !it.done(); it.Advance()) {
    444     frames.Clear();
    445     it.frame()->Summarize(&frames);
    446     for (int i = frames.length() - 1; i >= 0; i--) {
    447       // Omit functions from native and extension scripts.
    448       if (frames[i].is_subject_to_debugging()) n++;
    449     }
    450   }
    451   return Smi::FromInt(n);
    452 }
    453 
    454 static const int kFrameDetailsFrameIdIndex = 0;
    455 static const int kFrameDetailsReceiverIndex = 1;
    456 static const int kFrameDetailsFunctionIndex = 2;
    457 static const int kFrameDetailsScriptIndex = 3;
    458 static const int kFrameDetailsArgumentCountIndex = 4;
    459 static const int kFrameDetailsLocalCountIndex = 5;
    460 static const int kFrameDetailsSourcePositionIndex = 6;
    461 static const int kFrameDetailsConstructCallIndex = 7;
    462 static const int kFrameDetailsAtReturnIndex = 8;
    463 static const int kFrameDetailsFlagsIndex = 9;
    464 static const int kFrameDetailsFirstDynamicIndex = 10;
    465 
    466 // Return an array with frame details
    467 // args[0]: number: break id
    468 // args[1]: number: frame index
    469 //
    470 // The array returned contains the following information:
    471 // 0: Frame id
    472 // 1: Receiver
    473 // 2: Function
    474 // 3: Script
    475 // 4: Argument count
    476 // 5: Local count
    477 // 6: Source position
    478 // 7: Constructor call
    479 // 8: Is at return
    480 // 9: Flags
    481 // Arguments name, value
    482 // Locals name, value
    483 // Return value if any
    484 RUNTIME_FUNCTION(Runtime_GetFrameDetails) {
    485   HandleScope scope(isolate);
    486   DCHECK_EQ(2, args.length());
    487   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
    488   CHECK(isolate->debug()->CheckExecutionState(break_id));
    489 
    490   CONVERT_NUMBER_CHECKED(int, index, Int32, args[1]);
    491   Heap* heap = isolate->heap();
    492 
    493   // Find the relevant frame with the requested index.
    494   StackFrame::Id id = isolate->debug()->break_frame_id();
    495   if (id == StackFrame::NO_ID) {
    496     // If there are no JavaScript stack frames return undefined.
    497     return heap->undefined_value();
    498   }
    499 
    500   StackTraceFrameIterator it(isolate, id);
    501   // Inlined frame index in optimized frame, starting from outer function.
    502   int inlined_frame_index =
    503       DebugFrameHelper::FindIndexedNonNativeFrame(&it, index);
    504   if (inlined_frame_index == -1) return heap->undefined_value();
    505 
    506   FrameInspector frame_inspector(it.frame(), inlined_frame_index, isolate);
    507 
    508   // Traverse the saved contexts chain to find the active context for the
    509   // selected frame.
    510   SaveContext* save =
    511       DebugFrameHelper::FindSavedContextForFrame(isolate, it.frame());
    512 
    513   // Get the frame id.
    514   Handle<Object> frame_id(DebugFrameHelper::WrapFrameId(it.frame()->id()),
    515                           isolate);
    516 
    517   if (frame_inspector.summary().IsWasm()) {
    518     // Create the details array (no dynamic information for wasm).
    519     Handle<FixedArray> details =
    520         isolate->factory()->NewFixedArray(kFrameDetailsFirstDynamicIndex);
    521 
    522     // Add the frame id.
    523     details->set(kFrameDetailsFrameIdIndex, *frame_id);
    524 
    525     // Add the function name.
    526     Handle<String> func_name = frame_inspector.summary().FunctionName();
    527     details->set(kFrameDetailsFunctionIndex, *func_name);
    528 
    529     // Add the script wrapper
    530     Handle<Object> script_wrapper =
    531         Script::GetWrapper(frame_inspector.GetScript());
    532     details->set(kFrameDetailsScriptIndex, *script_wrapper);
    533 
    534     // Add the arguments count.
    535     details->set(kFrameDetailsArgumentCountIndex, Smi::kZero);
    536 
    537     // Add the locals count
    538     details->set(kFrameDetailsLocalCountIndex, Smi::kZero);
    539 
    540     // Add the source position.
    541     int position = frame_inspector.summary().SourcePosition();
    542     details->set(kFrameDetailsSourcePositionIndex, Smi::FromInt(position));
    543 
    544     // Add the constructor information.
    545     details->set(kFrameDetailsConstructCallIndex, heap->ToBoolean(false));
    546 
    547     // Add the at return information.
    548     details->set(kFrameDetailsAtReturnIndex, heap->ToBoolean(false));
    549 
    550     // Add flags to indicate information on whether this frame is
    551     //   bit 0: invoked in the debugger context.
    552     //   bit 1: optimized frame.
    553     //   bit 2: inlined in optimized frame
    554     int flags = 0;
    555     if (*save->context() == *isolate->debug()->debug_context()) {
    556       flags |= 1 << 0;
    557     }
    558     details->set(kFrameDetailsFlagsIndex, Smi::FromInt(flags));
    559 
    560     return *isolate->factory()->NewJSArrayWithElements(details);
    561   }
    562 
    563   // Find source position in unoptimized code.
    564   int position = frame_inspector.GetSourcePosition();
    565 
    566   // Handle JavaScript frames.
    567   bool is_optimized = it.frame()->is_optimized();
    568 
    569   // Check for constructor frame.
    570   bool constructor = frame_inspector.IsConstructor();
    571 
    572   // Get scope info and read from it for local variable information.
    573   Handle<JSFunction> function =
    574       Handle<JSFunction>::cast(frame_inspector.GetFunction());
    575   CHECK(function->shared()->IsSubjectToDebugging());
    576   Handle<SharedFunctionInfo> shared(function->shared());
    577   Handle<ScopeInfo> scope_info(shared->scope_info());
    578   DCHECK(*scope_info != ScopeInfo::Empty(isolate));
    579 
    580   // Get the locals names and values into a temporary array.
    581   Handle<Object> maybe_context = frame_inspector.GetContext();
    582   const int local_count_with_synthetic = maybe_context->IsContext()
    583                                              ? scope_info->LocalCount()
    584                                              : scope_info->StackLocalCount();
    585   int local_count = local_count_with_synthetic;
    586   for (int slot = 0; slot < local_count_with_synthetic; ++slot) {
    587     // Hide compiler-introduced temporary variables, whether on the stack or on
    588     // the context.
    589     if (ScopeInfo::VariableIsSynthetic(scope_info->LocalName(slot))) {
    590       local_count--;
    591     }
    592   }
    593 
    594   List<Handle<Object>> locals;
    595   // Fill in the values of the locals.
    596   int i = 0;
    597   for (; i < scope_info->StackLocalCount(); ++i) {
    598     // Use the value from the stack.
    599     if (ScopeInfo::VariableIsSynthetic(scope_info->LocalName(i))) continue;
    600     locals.Add(Handle<String>(scope_info->LocalName(i), isolate));
    601     Handle<Object> value =
    602         frame_inspector.GetExpression(scope_info->StackLocalIndex(i));
    603     // TODO(yangguo): We convert optimized out values to {undefined} when they
    604     // are passed to the debugger. Eventually we should handle them somehow.
    605     if (value->IsOptimizedOut(isolate)) {
    606       value = isolate->factory()->undefined_value();
    607     }
    608     locals.Add(value);
    609   }
    610   if (locals.length() < local_count * 2) {
    611     // Get the context containing declarations.
    612     DCHECK(maybe_context->IsContext());
    613     Handle<Context> context(Context::cast(*maybe_context)->closure_context());
    614 
    615     for (; i < scope_info->LocalCount(); ++i) {
    616       Handle<String> name(scope_info->LocalName(i));
    617       if (ScopeInfo::VariableIsSynthetic(*name)) continue;
    618       VariableMode mode;
    619       InitializationFlag init_flag;
    620       MaybeAssignedFlag maybe_assigned_flag;
    621       locals.Add(name);
    622       int context_slot_index = ScopeInfo::ContextSlotIndex(
    623           scope_info, name, &mode, &init_flag, &maybe_assigned_flag);
    624       Object* value = context->get(context_slot_index);
    625       locals.Add(Handle<Object>(value, isolate));
    626     }
    627   }
    628 
    629   // Check whether this frame is positioned at return. If not top
    630   // frame or if the frame is optimized it cannot be at a return.
    631   bool at_return = false;
    632   if (!is_optimized && index == 0) {
    633     at_return = isolate->debug()->IsBreakAtReturn(it.javascript_frame());
    634   }
    635 
    636   // If positioned just before return find the value to be returned and add it
    637   // to the frame information.
    638   Handle<Object> return_value = isolate->factory()->undefined_value();
    639   if (at_return) {
    640     return_value = handle(isolate->debug()->return_value(), isolate);
    641   }
    642 
    643   // Now advance to the arguments adapter frame (if any). It contains all
    644   // the provided parameters whereas the function frame always have the number
    645   // of arguments matching the functions parameters. The rest of the
    646   // information (except for what is collected above) is the same.
    647   if ((inlined_frame_index == 0) &&
    648       it.javascript_frame()->has_adapted_arguments()) {
    649     it.AdvanceToArgumentsFrame();
    650     frame_inspector.SetArgumentsFrame(it.frame());
    651   }
    652 
    653   // Find the number of arguments to fill. At least fill the number of
    654   // parameters for the function and fill more if more parameters are provided.
    655   int argument_count = scope_info->ParameterCount();
    656   if (argument_count < frame_inspector.GetParametersCount()) {
    657     argument_count = frame_inspector.GetParametersCount();
    658   }
    659 
    660   // Calculate the size of the result.
    661   int details_size = kFrameDetailsFirstDynamicIndex +
    662                      2 * (argument_count + local_count) + (at_return ? 1 : 0);
    663   Handle<FixedArray> details = isolate->factory()->NewFixedArray(details_size);
    664 
    665   // Add the frame id.
    666   details->set(kFrameDetailsFrameIdIndex, *frame_id);
    667 
    668   // Add the function (same as in function frame).
    669   details->set(kFrameDetailsFunctionIndex, *(frame_inspector.GetFunction()));
    670 
    671   // Add the script wrapper
    672   Handle<Object> script_wrapper =
    673       Script::GetWrapper(frame_inspector.GetScript());
    674   details->set(kFrameDetailsScriptIndex, *script_wrapper);
    675 
    676   // Add the arguments count.
    677   details->set(kFrameDetailsArgumentCountIndex, Smi::FromInt(argument_count));
    678 
    679   // Add the locals count
    680   details->set(kFrameDetailsLocalCountIndex, Smi::FromInt(local_count));
    681 
    682   // Add the source position.
    683   if (position != kNoSourcePosition) {
    684     details->set(kFrameDetailsSourcePositionIndex, Smi::FromInt(position));
    685   } else {
    686     details->set(kFrameDetailsSourcePositionIndex, heap->undefined_value());
    687   }
    688 
    689   // Add the constructor information.
    690   details->set(kFrameDetailsConstructCallIndex, heap->ToBoolean(constructor));
    691 
    692   // Add the at return information.
    693   details->set(kFrameDetailsAtReturnIndex, heap->ToBoolean(at_return));
    694 
    695   // Add flags to indicate information on whether this frame is
    696   //   bit 0: invoked in the debugger context.
    697   //   bit 1: optimized frame.
    698   //   bit 2: inlined in optimized frame
    699   int flags = 0;
    700   if (*save->context() == *isolate->debug()->debug_context()) {
    701     flags |= 1 << 0;
    702   }
    703   if (is_optimized) {
    704     flags |= 1 << 1;
    705     flags |= inlined_frame_index << 2;
    706   }
    707   details->set(kFrameDetailsFlagsIndex, Smi::FromInt(flags));
    708 
    709   // Fill the dynamic part.
    710   int details_index = kFrameDetailsFirstDynamicIndex;
    711 
    712   // Add arguments name and value.
    713   for (int i = 0; i < argument_count; i++) {
    714     // Name of the argument.
    715     if (i < scope_info->ParameterCount()) {
    716       details->set(details_index++, scope_info->ParameterName(i));
    717     } else {
    718       details->set(details_index++, heap->undefined_value());
    719     }
    720 
    721     // Parameter value.
    722     if (i < frame_inspector.GetParametersCount()) {
    723       // Get the value from the stack.
    724       details->set(details_index++, *(frame_inspector.GetParameter(i)));
    725     } else {
    726       details->set(details_index++, heap->undefined_value());
    727     }
    728   }
    729 
    730   // Add locals name and value from the temporary copy from the function frame.
    731   for (const auto& local : locals) details->set(details_index++, *local);
    732 
    733   // Add the value being returned.
    734   if (at_return) {
    735     details->set(details_index++, *return_value);
    736   }
    737 
    738   // Add the receiver (same as in function frame).
    739   Handle<Object> receiver = frame_inspector.summary().receiver();
    740   DCHECK(function->shared()->IsUserJavaScript());
    741   // Optimized frames only restore the receiver as best-effort (see
    742   // OptimizedFrame::Summarize).
    743   DCHECK_IMPLIES(!is_optimized && is_sloppy(shared->language_mode()),
    744                  receiver->IsJSReceiver());
    745   details->set(kFrameDetailsReceiverIndex, *receiver);
    746 
    747   DCHECK_EQ(details_size, details_index);
    748   return *isolate->factory()->NewJSArrayWithElements(details);
    749 }
    750 
    751 
    752 RUNTIME_FUNCTION(Runtime_GetScopeCount) {
    753   HandleScope scope(isolate);
    754   DCHECK_EQ(2, args.length());
    755   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
    756   CHECK(isolate->debug()->CheckExecutionState(break_id));
    757 
    758   CONVERT_SMI_ARG_CHECKED(wrapped_id, 1);
    759 
    760   // Get the frame where the debugging is performed.
    761   StackFrame::Id id = DebugFrameHelper::UnwrapFrameId(wrapped_id);
    762   StackTraceFrameIterator it(isolate, id);
    763   StandardFrame* frame = it.frame();
    764   if (it.frame()->is_wasm()) return 0;
    765 
    766   FrameInspector frame_inspector(frame, 0, isolate);
    767 
    768   // Count the visible scopes.
    769   int n = 0;
    770   for (ScopeIterator it(isolate, &frame_inspector); !it.Done(); it.Next()) {
    771     n++;
    772   }
    773 
    774   return Smi::FromInt(n);
    775 }
    776 
    777 
    778 // Return an array with scope details
    779 // args[0]: number: break id
    780 // args[1]: number: frame index
    781 // args[2]: number: inlined frame index
    782 // args[3]: number: scope index
    783 //
    784 // The array returned contains the following information:
    785 // 0: Scope type
    786 // 1: Scope object
    787 RUNTIME_FUNCTION(Runtime_GetScopeDetails) {
    788   HandleScope scope(isolate);
    789   DCHECK_EQ(4, args.length());
    790   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
    791   CHECK(isolate->debug()->CheckExecutionState(break_id));
    792 
    793   CONVERT_SMI_ARG_CHECKED(wrapped_id, 1);
    794   CONVERT_NUMBER_CHECKED(int, inlined_jsframe_index, Int32, args[2]);
    795   CONVERT_NUMBER_CHECKED(int, index, Int32, args[3]);
    796 
    797   // Get the frame where the debugging is performed.
    798   StackFrame::Id id = DebugFrameHelper::UnwrapFrameId(wrapped_id);
    799   StackTraceFrameIterator frame_it(isolate, id);
    800   // Wasm has no scopes, this must be javascript.
    801   JavaScriptFrame* frame = JavaScriptFrame::cast(frame_it.frame());
    802   FrameInspector frame_inspector(frame, inlined_jsframe_index, isolate);
    803 
    804   // Find the requested scope.
    805   int n = 0;
    806   ScopeIterator it(isolate, &frame_inspector);
    807   for (; !it.Done() && n < index; it.Next()) {
    808     n++;
    809   }
    810   if (it.Done()) {
    811     return isolate->heap()->undefined_value();
    812   }
    813   RETURN_RESULT_OR_FAILURE(isolate, it.MaterializeScopeDetails());
    814 }
    815 
    816 
    817 // Return an array of scope details
    818 // args[0]: number: break id
    819 // args[1]: number: frame index
    820 // args[2]: number: inlined frame index
    821 // args[3]: boolean: ignore nested scopes
    822 //
    823 // The array returned contains arrays with the following information:
    824 // 0: Scope type
    825 // 1: Scope object
    826 RUNTIME_FUNCTION(Runtime_GetAllScopesDetails) {
    827   HandleScope scope(isolate);
    828   DCHECK(args.length() == 3 || args.length() == 4);
    829   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
    830   CHECK(isolate->debug()->CheckExecutionState(break_id));
    831 
    832   CONVERT_SMI_ARG_CHECKED(wrapped_id, 1);
    833   CONVERT_NUMBER_CHECKED(int, inlined_jsframe_index, Int32, args[2]);
    834 
    835   ScopeIterator::Option option = ScopeIterator::DEFAULT;
    836   if (args.length() == 4) {
    837     CONVERT_BOOLEAN_ARG_CHECKED(flag, 3);
    838     if (flag) option = ScopeIterator::IGNORE_NESTED_SCOPES;
    839   }
    840 
    841   // Get the frame where the debugging is performed.
    842   StackFrame::Id id = DebugFrameHelper::UnwrapFrameId(wrapped_id);
    843   StackTraceFrameIterator frame_it(isolate, id);
    844   StandardFrame* frame = frame_it.frame();
    845   FrameInspector frame_inspector(frame, inlined_jsframe_index, isolate);
    846 
    847   List<Handle<JSObject> > result(4);
    848   ScopeIterator it(isolate, &frame_inspector, option);
    849   for (; !it.Done(); it.Next()) {
    850     Handle<JSObject> details;
    851     ASSIGN_RETURN_FAILURE_ON_EXCEPTION(isolate, details,
    852                                        it.MaterializeScopeDetails());
    853     result.Add(details);
    854   }
    855 
    856   Handle<FixedArray> array = isolate->factory()->NewFixedArray(result.length());
    857   for (int i = 0; i < result.length(); ++i) {
    858     array->set(i, *result[i]);
    859   }
    860   return *isolate->factory()->NewJSArrayWithElements(array);
    861 }
    862 
    863 
    864 RUNTIME_FUNCTION(Runtime_GetFunctionScopeCount) {
    865   HandleScope scope(isolate);
    866   DCHECK_EQ(1, args.length());
    867 
    868   // Check arguments.
    869   CONVERT_ARG_HANDLE_CHECKED(JSReceiver, function, 0);
    870 
    871   // Count the visible scopes.
    872   int n = 0;
    873   if (function->IsJSFunction()) {
    874     for (ScopeIterator it(isolate, Handle<JSFunction>::cast(function));
    875          !it.Done(); it.Next()) {
    876       n++;
    877     }
    878   }
    879 
    880   return Smi::FromInt(n);
    881 }
    882 
    883 
    884 RUNTIME_FUNCTION(Runtime_GetFunctionScopeDetails) {
    885   HandleScope scope(isolate);
    886   DCHECK_EQ(2, args.length());
    887 
    888   // Check arguments.
    889   CONVERT_ARG_HANDLE_CHECKED(JSFunction, fun, 0);
    890   CONVERT_NUMBER_CHECKED(int, index, Int32, args[1]);
    891 
    892   // Find the requested scope.
    893   int n = 0;
    894   ScopeIterator it(isolate, fun);
    895   for (; !it.Done() && n < index; it.Next()) {
    896     n++;
    897   }
    898   if (it.Done()) {
    899     return isolate->heap()->undefined_value();
    900   }
    901 
    902   RETURN_RESULT_OR_FAILURE(isolate, it.MaterializeScopeDetails());
    903 }
    904 
    905 RUNTIME_FUNCTION(Runtime_GetGeneratorScopeCount) {
    906   HandleScope scope(isolate);
    907   DCHECK_EQ(1, args.length());
    908 
    909   if (!args[0]->IsJSGeneratorObject()) return Smi::kZero;
    910 
    911   // Check arguments.
    912   CONVERT_ARG_HANDLE_CHECKED(JSGeneratorObject, gen, 0);
    913 
    914   // Count the visible scopes.
    915   int n = 0;
    916   for (ScopeIterator it(isolate, gen); !it.Done(); it.Next()) {
    917     n++;
    918   }
    919 
    920   return Smi::FromInt(n);
    921 }
    922 
    923 RUNTIME_FUNCTION(Runtime_GetGeneratorScopeDetails) {
    924   HandleScope scope(isolate);
    925   DCHECK_EQ(2, args.length());
    926 
    927   if (!args[0]->IsJSGeneratorObject()) {
    928     return isolate->heap()->undefined_value();
    929   }
    930 
    931   // Check arguments.
    932   CONVERT_ARG_HANDLE_CHECKED(JSGeneratorObject, gen, 0);
    933   CONVERT_NUMBER_CHECKED(int, index, Int32, args[1]);
    934 
    935   // Find the requested scope.
    936   int n = 0;
    937   ScopeIterator it(isolate, gen);
    938   for (; !it.Done() && n < index; it.Next()) {
    939     n++;
    940   }
    941   if (it.Done()) {
    942     return isolate->heap()->undefined_value();
    943   }
    944 
    945   RETURN_RESULT_OR_FAILURE(isolate, it.MaterializeScopeDetails());
    946 }
    947 
    948 static bool SetScopeVariableValue(ScopeIterator* it, int index,
    949                                   Handle<String> variable_name,
    950                                   Handle<Object> new_value) {
    951   for (int n = 0; !it->Done() && n < index; it->Next()) {
    952     n++;
    953   }
    954   if (it->Done()) {
    955     return false;
    956   }
    957   return it->SetVariableValue(variable_name, new_value);
    958 }
    959 
    960 
    961 // Change variable value in closure or local scope
    962 // args[0]: number or JsFunction: break id or function
    963 // args[1]: number: frame index (when arg[0] is break id)
    964 // args[2]: number: inlined frame index (when arg[0] is break id)
    965 // args[3]: number: scope index
    966 // args[4]: string: variable name
    967 // args[5]: object: new value
    968 //
    969 // Return true if success and false otherwise
    970 RUNTIME_FUNCTION(Runtime_SetScopeVariableValue) {
    971   HandleScope scope(isolate);
    972   DCHECK_EQ(6, args.length());
    973 
    974   // Check arguments.
    975   CONVERT_NUMBER_CHECKED(int, index, Int32, args[3]);
    976   CONVERT_ARG_HANDLE_CHECKED(String, variable_name, 4);
    977   CONVERT_ARG_HANDLE_CHECKED(Object, new_value, 5);
    978 
    979   bool res;
    980   if (args[0]->IsNumber()) {
    981     CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
    982     CHECK(isolate->debug()->CheckExecutionState(break_id));
    983 
    984     CONVERT_SMI_ARG_CHECKED(wrapped_id, 1);
    985     CONVERT_NUMBER_CHECKED(int, inlined_jsframe_index, Int32, args[2]);
    986 
    987     // Get the frame where the debugging is performed.
    988     StackFrame::Id id = DebugFrameHelper::UnwrapFrameId(wrapped_id);
    989     StackTraceFrameIterator frame_it(isolate, id);
    990     // Wasm has no scopes, this must be javascript.
    991     JavaScriptFrame* frame = JavaScriptFrame::cast(frame_it.frame());
    992     FrameInspector frame_inspector(frame, inlined_jsframe_index, isolate);
    993 
    994     ScopeIterator it(isolate, &frame_inspector);
    995     res = SetScopeVariableValue(&it, index, variable_name, new_value);
    996   } else if (args[0]->IsJSFunction()) {
    997     CONVERT_ARG_HANDLE_CHECKED(JSFunction, fun, 0);
    998     ScopeIterator it(isolate, fun);
    999     res = SetScopeVariableValue(&it, index, variable_name, new_value);
   1000   } else {
   1001     CONVERT_ARG_HANDLE_CHECKED(JSGeneratorObject, gen, 0);
   1002     ScopeIterator it(isolate, gen);
   1003     res = SetScopeVariableValue(&it, index, variable_name, new_value);
   1004   }
   1005 
   1006   return isolate->heap()->ToBoolean(res);
   1007 }
   1008 
   1009 
   1010 RUNTIME_FUNCTION(Runtime_DebugPrintScopes) {
   1011   HandleScope scope(isolate);
   1012   DCHECK_EQ(0, args.length());
   1013 
   1014 #ifdef DEBUG
   1015   // Print the scopes for the top frame.
   1016   StackFrameLocator locator(isolate);
   1017   JavaScriptFrame* frame = locator.FindJavaScriptFrame(0);
   1018   FrameInspector frame_inspector(frame, 0, isolate);
   1019 
   1020   for (ScopeIterator it(isolate, &frame_inspector); !it.Done(); it.Next()) {
   1021     it.DebugPrint();
   1022   }
   1023 #endif
   1024   return isolate->heap()->undefined_value();
   1025 }
   1026 
   1027 
   1028 // Sets the disable break state
   1029 // args[0]: disable break state
   1030 RUNTIME_FUNCTION(Runtime_SetBreakPointsActive) {
   1031   HandleScope scope(isolate);
   1032   DCHECK_EQ(1, args.length());
   1033   CONVERT_BOOLEAN_ARG_CHECKED(active, 0);
   1034   isolate->debug()->set_break_points_active(active);
   1035   return isolate->heap()->undefined_value();
   1036 }
   1037 
   1038 
   1039 static bool IsPositionAlignmentCodeCorrect(int alignment) {
   1040   return alignment == STATEMENT_ALIGNED || alignment == BREAK_POSITION_ALIGNED;
   1041 }
   1042 
   1043 
   1044 RUNTIME_FUNCTION(Runtime_GetBreakLocations) {
   1045   HandleScope scope(isolate);
   1046   DCHECK_EQ(2, args.length());
   1047   CHECK(isolate->debug()->is_active());
   1048   CONVERT_ARG_HANDLE_CHECKED(JSFunction, fun, 0);
   1049   CONVERT_NUMBER_CHECKED(int32_t, statement_aligned_code, Int32, args[1]);
   1050 
   1051   if (!IsPositionAlignmentCodeCorrect(statement_aligned_code)) {
   1052     return isolate->ThrowIllegalOperation();
   1053   }
   1054   BreakPositionAlignment alignment =
   1055       static_cast<BreakPositionAlignment>(statement_aligned_code);
   1056 
   1057   Handle<SharedFunctionInfo> shared(fun->shared());
   1058   // Find the number of break points
   1059   Handle<Object> break_locations =
   1060       Debug::GetSourceBreakLocations(shared, alignment);
   1061   if (break_locations->IsUndefined(isolate)) {
   1062     return isolate->heap()->undefined_value();
   1063   }
   1064   // Return array as JS array
   1065   return *isolate->factory()->NewJSArrayWithElements(
   1066       Handle<FixedArray>::cast(break_locations));
   1067 }
   1068 
   1069 
   1070 // Set a break point in a function.
   1071 // args[0]: function
   1072 // args[1]: number: break source position (within the function source)
   1073 // args[2]: number: break point object
   1074 RUNTIME_FUNCTION(Runtime_SetFunctionBreakPoint) {
   1075   HandleScope scope(isolate);
   1076   DCHECK_EQ(3, args.length());
   1077   CHECK(isolate->debug()->is_active());
   1078   CONVERT_ARG_HANDLE_CHECKED(JSFunction, function, 0);
   1079   CONVERT_NUMBER_CHECKED(int32_t, source_position, Int32, args[1]);
   1080   CHECK(source_position >= function->shared()->start_position() &&
   1081         source_position <= function->shared()->end_position());
   1082   CONVERT_ARG_HANDLE_CHECKED(Object, break_point_object_arg, 2);
   1083 
   1084   // Set break point.
   1085   CHECK(isolate->debug()->SetBreakPoint(function, break_point_object_arg,
   1086                                         &source_position));
   1087 
   1088   return Smi::FromInt(source_position);
   1089 }
   1090 
   1091 
   1092 // Changes the state of a break point in a script and returns source position
   1093 // where break point was set. NOTE: Regarding performance see the NOTE for
   1094 // GetScriptFromScriptData.
   1095 // args[0]: script to set break point in
   1096 // args[1]: number: break source position (within the script source)
   1097 // args[2]: number, breakpoint position alignment
   1098 // args[3]: number: break point object
   1099 RUNTIME_FUNCTION(Runtime_SetScriptBreakPoint) {
   1100   HandleScope scope(isolate);
   1101   DCHECK_EQ(4, args.length());
   1102   CHECK(isolate->debug()->is_active());
   1103   CONVERT_ARG_HANDLE_CHECKED(JSValue, wrapper, 0);
   1104   CONVERT_NUMBER_CHECKED(int32_t, source_position, Int32, args[1]);
   1105   CHECK(source_position >= 0);
   1106   CONVERT_NUMBER_CHECKED(int32_t, statement_aligned_code, Int32, args[2]);
   1107   CONVERT_ARG_HANDLE_CHECKED(Object, break_point_object_arg, 3);
   1108 
   1109   if (!IsPositionAlignmentCodeCorrect(statement_aligned_code)) {
   1110     return isolate->ThrowIllegalOperation();
   1111   }
   1112   BreakPositionAlignment alignment =
   1113       static_cast<BreakPositionAlignment>(statement_aligned_code);
   1114 
   1115   // Get the script from the script wrapper.
   1116   CHECK(wrapper->value()->IsScript());
   1117   Handle<Script> script(Script::cast(wrapper->value()));
   1118 
   1119   // Set break point.
   1120   if (!isolate->debug()->SetBreakPointForScript(script, break_point_object_arg,
   1121                                                 &source_position, alignment)) {
   1122     return isolate->heap()->undefined_value();
   1123   }
   1124 
   1125   return Smi::FromInt(source_position);
   1126 }
   1127 
   1128 
   1129 // Clear a break point
   1130 // args[0]: number: break point object
   1131 RUNTIME_FUNCTION(Runtime_ClearBreakPoint) {
   1132   HandleScope scope(isolate);
   1133   DCHECK_EQ(1, args.length());
   1134   CHECK(isolate->debug()->is_active());
   1135   CONVERT_ARG_HANDLE_CHECKED(Object, break_point_object_arg, 0);
   1136 
   1137   // Clear break point.
   1138   isolate->debug()->ClearBreakPoint(break_point_object_arg);
   1139 
   1140   return isolate->heap()->undefined_value();
   1141 }
   1142 
   1143 
   1144 // Change the state of break on exceptions.
   1145 // args[0]: Enum value indicating whether to affect caught/uncaught exceptions.
   1146 // args[1]: Boolean indicating on/off.
   1147 RUNTIME_FUNCTION(Runtime_ChangeBreakOnException) {
   1148   HandleScope scope(isolate);
   1149   DCHECK_EQ(2, args.length());
   1150   CONVERT_NUMBER_CHECKED(uint32_t, type_arg, Uint32, args[0]);
   1151   CONVERT_BOOLEAN_ARG_CHECKED(enable, 1);
   1152 
   1153   // If the number doesn't match an enum value, the ChangeBreakOnException
   1154   // function will default to affecting caught exceptions.
   1155   ExceptionBreakType type = static_cast<ExceptionBreakType>(type_arg);
   1156   // Update break point state.
   1157   isolate->debug()->ChangeBreakOnException(type, enable);
   1158   return isolate->heap()->undefined_value();
   1159 }
   1160 
   1161 
   1162 // Returns the state of break on exceptions
   1163 // args[0]: boolean indicating uncaught exceptions
   1164 RUNTIME_FUNCTION(Runtime_IsBreakOnException) {
   1165   HandleScope scope(isolate);
   1166   DCHECK_EQ(1, args.length());
   1167   CONVERT_NUMBER_CHECKED(uint32_t, type_arg, Uint32, args[0]);
   1168 
   1169   ExceptionBreakType type = static_cast<ExceptionBreakType>(type_arg);
   1170   bool result = isolate->debug()->IsBreakOnException(type);
   1171   return Smi::FromInt(result);
   1172 }
   1173 
   1174 
   1175 // Prepare for stepping
   1176 // args[0]: break id for checking execution state
   1177 // args[1]: step action from the enumeration StepAction
   1178 // args[2]: number of times to perform the step, for step out it is the number
   1179 //          of frames to step down.
   1180 RUNTIME_FUNCTION(Runtime_PrepareStep) {
   1181   HandleScope scope(isolate);
   1182   DCHECK_EQ(2, args.length());
   1183   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
   1184   CHECK(isolate->debug()->CheckExecutionState(break_id));
   1185 
   1186   if (!args[1]->IsNumber()) {
   1187     return isolate->Throw(isolate->heap()->illegal_argument_string());
   1188   }
   1189 
   1190   // Get the step action and check validity.
   1191   StepAction step_action = static_cast<StepAction>(NumberToInt32(args[1]));
   1192   if (step_action != StepIn && step_action != StepNext &&
   1193       step_action != StepOut) {
   1194     return isolate->Throw(isolate->heap()->illegal_argument_string());
   1195   }
   1196 
   1197   // Clear all current stepping setup.
   1198   isolate->debug()->ClearStepping();
   1199 
   1200   // Prepare step.
   1201   isolate->debug()->PrepareStep(static_cast<StepAction>(step_action));
   1202   return isolate->heap()->undefined_value();
   1203 }
   1204 
   1205 // Clear all stepping set by PrepareStep.
   1206 RUNTIME_FUNCTION(Runtime_ClearStepping) {
   1207   HandleScope scope(isolate);
   1208   DCHECK_EQ(0, args.length());
   1209   CHECK(isolate->debug()->is_active());
   1210   isolate->debug()->ClearStepping();
   1211   return isolate->heap()->undefined_value();
   1212 }
   1213 
   1214 
   1215 RUNTIME_FUNCTION(Runtime_DebugEvaluate) {
   1216   HandleScope scope(isolate);
   1217 
   1218   // Check the execution state and decode arguments frame and source to be
   1219   // evaluated.
   1220   DCHECK_EQ(5, args.length());
   1221   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
   1222   CHECK(isolate->debug()->CheckExecutionState(break_id));
   1223 
   1224   CONVERT_SMI_ARG_CHECKED(wrapped_id, 1);
   1225   CONVERT_NUMBER_CHECKED(int, inlined_jsframe_index, Int32, args[2]);
   1226   CONVERT_ARG_HANDLE_CHECKED(String, source, 3);
   1227   CONVERT_BOOLEAN_ARG_CHECKED(throw_on_side_effect, 4);
   1228 
   1229   StackFrame::Id id = DebugFrameHelper::UnwrapFrameId(wrapped_id);
   1230 
   1231   RETURN_RESULT_OR_FAILURE(
   1232       isolate, DebugEvaluate::Local(isolate, id, inlined_jsframe_index, source,
   1233                                     throw_on_side_effect));
   1234 }
   1235 
   1236 
   1237 RUNTIME_FUNCTION(Runtime_DebugEvaluateGlobal) {
   1238   HandleScope scope(isolate);
   1239 
   1240   // Check the execution state and decode arguments frame and source to be
   1241   // evaluated.
   1242   DCHECK_EQ(2, args.length());
   1243   CONVERT_NUMBER_CHECKED(int, break_id, Int32, args[0]);
   1244   CHECK(isolate->debug()->CheckExecutionState(break_id));
   1245 
   1246   CONVERT_ARG_HANDLE_CHECKED(String, source, 1);
   1247 
   1248   RETURN_RESULT_OR_FAILURE(isolate, DebugEvaluate::Global(isolate, source));
   1249 }
   1250 
   1251 
   1252 RUNTIME_FUNCTION(Runtime_DebugGetLoadedScripts) {
   1253   HandleScope scope(isolate);
   1254   DCHECK_EQ(0, args.length());
   1255 
   1256   Handle<FixedArray> instances;
   1257   {
   1258     DebugScope debug_scope(isolate->debug());
   1259     if (debug_scope.failed()) {
   1260       DCHECK(isolate->has_pending_exception());
   1261       return isolate->heap()->exception();
   1262     }
   1263     // Fill the script objects.
   1264     instances = isolate->debug()->GetLoadedScripts();
   1265   }
   1266 
   1267   // Convert the script objects to proper JS objects.
   1268   for (int i = 0; i < instances->length(); i++) {
   1269     Handle<Script> script = Handle<Script>(Script::cast(instances->get(i)));
   1270     // Get the script wrapper in a local handle before calling GetScriptWrapper,
   1271     // because using
   1272     //   instances->set(i, *GetScriptWrapper(script))
   1273     // is unsafe as GetScriptWrapper might call GC and the C++ compiler might
   1274     // already have dereferenced the instances handle.
   1275     Handle<JSObject> wrapper = Script::GetWrapper(script);
   1276     instances->set(i, *wrapper);
   1277   }
   1278 
   1279   // Return result as a JS array.
   1280   return *isolate->factory()->NewJSArrayWithElements(instances);
   1281 }
   1282 
   1283 static bool HasInPrototypeChainIgnoringProxies(Isolate* isolate,
   1284                                                JSObject* object,
   1285                                                Object* proto) {
   1286   PrototypeIterator iter(isolate, object, kStartAtReceiver);
   1287   while (true) {
   1288     iter.AdvanceIgnoringProxies();
   1289     if (iter.IsAtEnd()) return false;
   1290     if (iter.GetCurrent() == proto) return true;
   1291   }
   1292 }
   1293 
   1294 
   1295 // Scan the heap for objects with direct references to an object
   1296 // args[0]: the object to find references to
   1297 // args[1]: constructor function for instances to exclude (Mirror)
   1298 // args[2]: the the maximum number of objects to return
   1299 RUNTIME_FUNCTION(Runtime_DebugReferencedBy) {
   1300   HandleScope scope(isolate);
   1301   DCHECK_EQ(3, args.length());
   1302   CONVERT_ARG_HANDLE_CHECKED(JSObject, target, 0);
   1303   CONVERT_ARG_HANDLE_CHECKED(Object, filter, 1);
   1304   CHECK(filter->IsUndefined(isolate) || filter->IsJSObject());
   1305   CONVERT_NUMBER_CHECKED(int32_t, max_references, Int32, args[2]);
   1306   CHECK(max_references >= 0);
   1307 
   1308   List<Handle<JSObject> > instances;
   1309   Heap* heap = isolate->heap();
   1310   {
   1311     HeapIterator iterator(heap, HeapIterator::kFilterUnreachable);
   1312     // Get the constructor function for context extension and arguments array.
   1313     Object* arguments_fun = isolate->sloppy_arguments_map()->GetConstructor();
   1314     HeapObject* heap_obj;
   1315     while ((heap_obj = iterator.next())) {
   1316       if (!heap_obj->IsJSObject()) continue;
   1317       JSObject* obj = JSObject::cast(heap_obj);
   1318       if (obj->IsJSContextExtensionObject()) continue;
   1319       if (obj->map()->GetConstructor() == arguments_fun) continue;
   1320       if (!obj->ReferencesObject(*target)) continue;
   1321       // Check filter if supplied. This is normally used to avoid
   1322       // references from mirror objects.
   1323       if (!filter->IsUndefined(isolate) &&
   1324           HasInPrototypeChainIgnoringProxies(isolate, obj, *filter)) {
   1325         continue;
   1326       }
   1327       if (obj->IsJSGlobalObject()) {
   1328         obj = JSGlobalObject::cast(obj)->global_proxy();
   1329       }
   1330       instances.Add(Handle<JSObject>(obj));
   1331       if (instances.length() == max_references) break;
   1332     }
   1333     // Iterate the rest of the heap to satisfy HeapIterator constraints.
   1334     while (iterator.next()) {
   1335     }
   1336   }
   1337 
   1338   Handle<FixedArray> result;
   1339   if (instances.length() == 1 && instances.last().is_identical_to(target)) {
   1340     // Check for circular reference only. This can happen when the object is
   1341     // only referenced from mirrors and has a circular reference in which case
   1342     // the object is not really alive and would have been garbage collected if
   1343     // not referenced from the mirror.
   1344     result = isolate->factory()->empty_fixed_array();
   1345   } else {
   1346     result = isolate->factory()->NewFixedArray(instances.length());
   1347     for (int i = 0; i < instances.length(); ++i) result->set(i, *instances[i]);
   1348   }
   1349   return *isolate->factory()->NewJSArrayWithElements(result);
   1350 }
   1351 
   1352 
   1353 // Scan the heap for objects constructed by a specific function.
   1354 // args[0]: the constructor to find instances of
   1355 // args[1]: the the maximum number of objects to return
   1356 RUNTIME_FUNCTION(Runtime_DebugConstructedBy) {
   1357   HandleScope scope(isolate);
   1358   DCHECK_EQ(2, args.length());
   1359   CONVERT_ARG_HANDLE_CHECKED(JSFunction, constructor, 0);
   1360   CONVERT_NUMBER_CHECKED(int32_t, max_references, Int32, args[1]);
   1361   CHECK(max_references >= 0);
   1362 
   1363   List<Handle<JSObject> > instances;
   1364   Heap* heap = isolate->heap();
   1365   {
   1366     HeapIterator iterator(heap, HeapIterator::kFilterUnreachable);
   1367     HeapObject* heap_obj;
   1368     while ((heap_obj = iterator.next())) {
   1369       if (!heap_obj->IsJSObject()) continue;
   1370       JSObject* obj = JSObject::cast(heap_obj);
   1371       if (obj->map()->GetConstructor() != *constructor) continue;
   1372       instances.Add(Handle<JSObject>(obj));
   1373       if (instances.length() == max_references) break;
   1374     }
   1375     // Iterate the rest of the heap to satisfy HeapIterator constraints.
   1376     while (iterator.next()) {
   1377     }
   1378   }
   1379 
   1380   Handle<FixedArray> result =
   1381       isolate->factory()->NewFixedArray(instances.length());
   1382   for (int i = 0; i < instances.length(); ++i) result->set(i, *instances[i]);
   1383   return *isolate->factory()->NewJSArrayWithElements(result);
   1384 }
   1385 
   1386 
   1387 // Find the effective prototype object as returned by __proto__.
   1388 // args[0]: the object to find the prototype for.
   1389 RUNTIME_FUNCTION(Runtime_DebugGetPrototype) {
   1390   HandleScope shs(isolate);
   1391   DCHECK_EQ(1, args.length());
   1392   CONVERT_ARG_HANDLE_CHECKED(JSObject, obj, 0);
   1393   // TODO(1543): Come up with a solution for clients to handle potential errors
   1394   // thrown by an intermediate proxy.
   1395   RETURN_RESULT_OR_FAILURE(isolate, JSReceiver::GetPrototype(isolate, obj));
   1396 }
   1397 
   1398 
   1399 // Patches script source (should be called upon BeforeCompile event).
   1400 // TODO(5530): Remove once uses in debug.js are gone.
   1401 RUNTIME_FUNCTION(Runtime_DebugSetScriptSource) {
   1402   HandleScope scope(isolate);
   1403   DCHECK_EQ(2, args.length());
   1404 
   1405   CONVERT_ARG_HANDLE_CHECKED(JSValue, script_wrapper, 0);
   1406   CONVERT_ARG_HANDLE_CHECKED(String, source, 1);
   1407 
   1408   CHECK(script_wrapper->value()->IsScript());
   1409   Handle<Script> script(Script::cast(script_wrapper->value()));
   1410 
   1411   // The following condition is not guaranteed to hold and a failure is also
   1412   // propagated to callers. Hence we fail gracefully here and don't crash.
   1413   if (script->compilation_state() != Script::COMPILATION_STATE_INITIAL) {
   1414     return isolate->ThrowIllegalOperation();
   1415   }
   1416 
   1417   script->set_source(*source);
   1418 
   1419   return isolate->heap()->undefined_value();
   1420 }
   1421 
   1422 
   1423 RUNTIME_FUNCTION(Runtime_FunctionGetInferredName) {
   1424   SealHandleScope shs(isolate);
   1425   DCHECK_EQ(1, args.length());
   1426 
   1427   CONVERT_ARG_CHECKED(Object, f, 0);
   1428   if (f->IsJSFunction()) {
   1429     return JSFunction::cast(f)->shared()->inferred_name();
   1430   }
   1431   return isolate->heap()->empty_string();
   1432 }
   1433 
   1434 
   1435 RUNTIME_FUNCTION(Runtime_FunctionGetDebugName) {
   1436   HandleScope scope(isolate);
   1437   DCHECK_EQ(1, args.length());
   1438 
   1439   CONVERT_ARG_HANDLE_CHECKED(JSReceiver, function, 0);
   1440 
   1441   if (function->IsJSBoundFunction()) {
   1442     RETURN_RESULT_OR_FAILURE(
   1443         isolate, JSBoundFunction::GetName(
   1444                      isolate, Handle<JSBoundFunction>::cast(function)));
   1445   } else {
   1446     return *JSFunction::GetDebugName(Handle<JSFunction>::cast(function));
   1447   }
   1448 }
   1449 
   1450 
   1451 RUNTIME_FUNCTION(Runtime_GetDebugContext) {
   1452   HandleScope scope(isolate);
   1453   DCHECK_EQ(0, args.length());
   1454   Handle<Context> context;
   1455   {
   1456     DebugScope debug_scope(isolate->debug());
   1457     if (debug_scope.failed()) {
   1458       DCHECK(isolate->has_pending_exception());
   1459       return isolate->heap()->exception();
   1460     }
   1461     context = isolate->debug()->GetDebugContext();
   1462   }
   1463   if (context.is_null()) return isolate->heap()->undefined_value();
   1464   context->set_security_token(isolate->native_context()->security_token());
   1465   return context->global_proxy();
   1466 }
   1467 
   1468 
   1469 // Performs a GC.
   1470 // Presently, it only does a full GC.
   1471 RUNTIME_FUNCTION(Runtime_CollectGarbage) {
   1472   SealHandleScope shs(isolate);
   1473   DCHECK_EQ(1, args.length());
   1474   isolate->heap()->CollectAllGarbage(Heap::kNoGCFlags,
   1475                                      GarbageCollectionReason::kRuntime);
   1476   return isolate->heap()->undefined_value();
   1477 }
   1478 
   1479 
   1480 // Gets the current heap usage.
   1481 RUNTIME_FUNCTION(Runtime_GetHeapUsage) {
   1482   SealHandleScope shs(isolate);
   1483   DCHECK_EQ(0, args.length());
   1484   int usage = static_cast<int>(isolate->heap()->SizeOfObjects());
   1485   if (!Smi::IsValid(usage)) {
   1486     return *isolate->factory()->NewNumberFromInt(usage);
   1487   }
   1488   return Smi::FromInt(usage);
   1489 }
   1490 
   1491 
   1492 // Finds the script object from the script data. NOTE: This operation uses
   1493 // heap traversal to find the function generated for the source position
   1494 // for the requested break point. For lazily compiled functions several heap
   1495 // traversals might be required rendering this operation as a rather slow
   1496 // operation. However for setting break points which is normally done through
   1497 // some kind of user interaction the performance is not crucial.
   1498 RUNTIME_FUNCTION(Runtime_GetScript) {
   1499   HandleScope scope(isolate);
   1500   DCHECK_EQ(1, args.length());
   1501   CONVERT_ARG_HANDLE_CHECKED(String, script_name, 0);
   1502 
   1503   Handle<Script> found;
   1504   {
   1505     Script::Iterator iterator(isolate);
   1506     Script* script = NULL;
   1507     while ((script = iterator.Next()) != NULL) {
   1508       if (!script->name()->IsString()) continue;
   1509       String* name = String::cast(script->name());
   1510       if (name->Equals(*script_name)) {
   1511         found = Handle<Script>(script, isolate);
   1512         break;
   1513       }
   1514     }
   1515   }
   1516 
   1517   if (found.is_null()) return isolate->heap()->undefined_value();
   1518   return *Script::GetWrapper(found);
   1519 }
   1520 
   1521 // TODO(5530): Remove once uses in debug.js are gone.
   1522 RUNTIME_FUNCTION(Runtime_ScriptLineCount) {
   1523   HandleScope scope(isolate);
   1524   DCHECK_EQ(1, args.length());
   1525   CONVERT_ARG_CHECKED(JSValue, script, 0);
   1526 
   1527   CHECK(script->value()->IsScript());
   1528   Handle<Script> script_handle = Handle<Script>(Script::cast(script->value()));
   1529 
   1530   if (script_handle->type() == Script::TYPE_WASM) {
   1531     // Return 0 for now; this function will disappear soon anyway.
   1532     return Smi::FromInt(0);
   1533   }
   1534 
   1535   Script::InitLineEnds(script_handle);
   1536 
   1537   FixedArray* line_ends_array = FixedArray::cast(script_handle->line_ends());
   1538   return Smi::FromInt(line_ends_array->length());
   1539 }
   1540 
   1541 namespace {
   1542 
   1543 int ScriptLinePosition(Handle<Script> script, int line) {
   1544   if (line < 0) return -1;
   1545 
   1546   if (script->type() == Script::TYPE_WASM) {
   1547     return WasmCompiledModule::cast(script->wasm_compiled_module())
   1548         ->GetFunctionOffset(line);
   1549   }
   1550 
   1551   Script::InitLineEnds(script);
   1552 
   1553   FixedArray* line_ends_array = FixedArray::cast(script->line_ends());
   1554   const int line_count = line_ends_array->length();
   1555   DCHECK_LT(0, line_count);
   1556 
   1557   if (line == 0) return 0;
   1558   // If line == line_count, we return the first position beyond the last line.
   1559   if (line > line_count) return -1;
   1560   return Smi::cast(line_ends_array->get(line - 1))->value() + 1;
   1561 }
   1562 
   1563 }  // namespace
   1564 
   1565 // TODO(5530): Remove once uses in debug.js are gone.
   1566 RUNTIME_FUNCTION(Runtime_ScriptLineStartPosition) {
   1567   HandleScope scope(isolate);
   1568   DCHECK_EQ(2, args.length());
   1569   CONVERT_ARG_CHECKED(JSValue, script, 0);
   1570   CONVERT_NUMBER_CHECKED(int32_t, line, Int32, args[1]);
   1571 
   1572   CHECK(script->value()->IsScript());
   1573   Handle<Script> script_handle = Handle<Script>(Script::cast(script->value()));
   1574 
   1575   return Smi::FromInt(ScriptLinePosition(script_handle, line));
   1576 }
   1577 
   1578 // TODO(5530): Remove once uses in debug.js are gone.
   1579 RUNTIME_FUNCTION(Runtime_ScriptLineEndPosition) {
   1580   HandleScope scope(isolate);
   1581   DCHECK_EQ(2, args.length());
   1582   CONVERT_ARG_CHECKED(JSValue, script, 0);
   1583   CONVERT_NUMBER_CHECKED(int32_t, line, Int32, args[1]);
   1584 
   1585   CHECK(script->value()->IsScript());
   1586   Handle<Script> script_handle = Handle<Script>(Script::cast(script->value()));
   1587 
   1588   if (script_handle->type() == Script::TYPE_WASM) {
   1589     // Return zero for now; this function will disappear soon anyway.
   1590     return Smi::FromInt(0);
   1591   }
   1592 
   1593   Script::InitLineEnds(script_handle);
   1594 
   1595   FixedArray* line_ends_array = FixedArray::cast(script_handle->line_ends());
   1596   const int line_count = line_ends_array->length();
   1597 
   1598   if (line < 0 || line >= line_count) {
   1599     return Smi::FromInt(-1);
   1600   } else {
   1601     return Smi::cast(line_ends_array->get(line));
   1602   }
   1603 }
   1604 
   1605 static Handle<Object> GetJSPositionInfo(Handle<Script> script, int position,
   1606                                         Script::OffsetFlag offset_flag,
   1607                                         Isolate* isolate) {
   1608   Script::PositionInfo info;
   1609   if (!Script::GetPositionInfo(script, position, &info, offset_flag)) {
   1610     return isolate->factory()->null_value();
   1611   }
   1612 
   1613   Handle<String> source = handle(String::cast(script->source()), isolate);
   1614   Handle<String> sourceText = script->type() == Script::TYPE_WASM
   1615                                   ? isolate->factory()->empty_string()
   1616                                   : isolate->factory()->NewSubString(
   1617                                         source, info.line_start, info.line_end);
   1618 
   1619   Handle<JSObject> jsinfo =
   1620       isolate->factory()->NewJSObject(isolate->object_function());
   1621 
   1622   JSObject::AddProperty(jsinfo, isolate->factory()->script_string(), script,
   1623                         NONE);
   1624   JSObject::AddProperty(jsinfo, isolate->factory()->position_string(),
   1625                         handle(Smi::FromInt(position), isolate), NONE);
   1626   JSObject::AddProperty(jsinfo, isolate->factory()->line_string(),
   1627                         handle(Smi::FromInt(info.line), isolate), NONE);
   1628   JSObject::AddProperty(jsinfo, isolate->factory()->column_string(),
   1629                         handle(Smi::FromInt(info.column), isolate), NONE);
   1630   JSObject::AddProperty(jsinfo, isolate->factory()->sourceText_string(),
   1631                         sourceText, NONE);
   1632 
   1633   return jsinfo;
   1634 }
   1635 
   1636 namespace {
   1637 
   1638 int ScriptLinePositionWithOffset(Handle<Script> script, int line, int offset) {
   1639   if (line < 0 || offset < 0) return -1;
   1640 
   1641   if (line == 0 || offset == 0)
   1642     return ScriptLinePosition(script, line) + offset;
   1643 
   1644   Script::PositionInfo info;
   1645   if (!Script::GetPositionInfo(script, offset, &info, Script::NO_OFFSET)) {
   1646     return -1;
   1647   }
   1648 
   1649   const int total_line = info.line + line;
   1650   return ScriptLinePosition(script, total_line);
   1651 }
   1652 
   1653 Handle<Object> ScriptLocationFromLine(Isolate* isolate, Handle<Script> script,
   1654                                       Handle<Object> opt_line,
   1655                                       Handle<Object> opt_column,
   1656                                       int32_t offset) {
   1657   // Line and column are possibly undefined and we need to handle these cases,
   1658   // additionally subtracting corresponding offsets.
   1659 
   1660   int32_t line = 0;
   1661   if (!opt_line->IsNullOrUndefined(isolate)) {
   1662     CHECK(opt_line->IsNumber());
   1663     line = NumberToInt32(*opt_line) - script->line_offset();
   1664   }
   1665 
   1666   int32_t column = 0;
   1667   if (!opt_column->IsNullOrUndefined(isolate)) {
   1668     CHECK(opt_column->IsNumber());
   1669     column = NumberToInt32(*opt_column);
   1670     if (line == 0) column -= script->column_offset();
   1671   }
   1672 
   1673   int line_position = ScriptLinePositionWithOffset(script, line, offset);
   1674   if (line_position < 0 || column < 0) return isolate->factory()->null_value();
   1675 
   1676   return GetJSPositionInfo(script, line_position + column, Script::NO_OFFSET,
   1677                            isolate);
   1678 }
   1679 
   1680 // Slow traversal over all scripts on the heap.
   1681 bool GetScriptById(Isolate* isolate, int needle, Handle<Script>* result) {
   1682   Script::Iterator iterator(isolate);
   1683   Script* script = NULL;
   1684   while ((script = iterator.Next()) != NULL) {
   1685     if (script->id() == needle) {
   1686       *result = handle(script);
   1687       return true;
   1688     }
   1689   }
   1690 
   1691   return false;
   1692 }
   1693 
   1694 }  // namespace
   1695 
   1696 // Get information on a specific source line and column possibly offset by a
   1697 // fixed source position. This function is used to find a source position from
   1698 // a line and column position. The fixed source position offset is typically
   1699 // used to find a source position in a function based on a line and column in
   1700 // the source for the function alone. The offset passed will then be the
   1701 // start position of the source for the function within the full script source.
   1702 // Note that incoming line and column parameters may be undefined, and are
   1703 // assumed to be passed *with* offsets.
   1704 // TODO(5530): Remove once uses in debug.js are gone.
   1705 RUNTIME_FUNCTION(Runtime_ScriptLocationFromLine) {
   1706   HandleScope scope(isolate);
   1707   DCHECK_EQ(4, args.length());
   1708   CONVERT_ARG_HANDLE_CHECKED(JSValue, script, 0);
   1709   CONVERT_ARG_HANDLE_CHECKED(Object, opt_line, 1);
   1710   CONVERT_ARG_HANDLE_CHECKED(Object, opt_column, 2);
   1711   CONVERT_NUMBER_CHECKED(int32_t, offset, Int32, args[3]);
   1712 
   1713   CHECK(script->value()->IsScript());
   1714   Handle<Script> script_handle = Handle<Script>(Script::cast(script->value()));
   1715 
   1716   return *ScriptLocationFromLine(isolate, script_handle, opt_line, opt_column,
   1717                                  offset);
   1718 }
   1719 
   1720 // TODO(5530): Rename once conflicting function has been deleted.
   1721 RUNTIME_FUNCTION(Runtime_ScriptLocationFromLine2) {
   1722   HandleScope scope(isolate);
   1723   DCHECK_EQ(4, args.length());
   1724   CONVERT_NUMBER_CHECKED(int32_t, scriptid, Int32, args[0]);
   1725   CONVERT_ARG_HANDLE_CHECKED(Object, opt_line, 1);
   1726   CONVERT_ARG_HANDLE_CHECKED(Object, opt_column, 2);
   1727   CONVERT_NUMBER_CHECKED(int32_t, offset, Int32, args[3]);
   1728 
   1729   Handle<Script> script;
   1730   CHECK(GetScriptById(isolate, scriptid, &script));
   1731 
   1732   return *ScriptLocationFromLine(isolate, script, opt_line, opt_column, offset);
   1733 }
   1734 
   1735 // TODO(5530): Remove once uses in debug.js are gone.
   1736 RUNTIME_FUNCTION(Runtime_ScriptPositionInfo) {
   1737   HandleScope scope(isolate);
   1738   DCHECK_EQ(3, args.length());
   1739   CONVERT_ARG_CHECKED(JSValue, script, 0);
   1740   CONVERT_NUMBER_CHECKED(int32_t, position, Int32, args[1]);
   1741   CONVERT_BOOLEAN_ARG_CHECKED(with_offset, 2);
   1742 
   1743   CHECK(script->value()->IsScript());
   1744   Handle<Script> script_handle = Handle<Script>(Script::cast(script->value()));
   1745 
   1746   const Script::OffsetFlag offset_flag =
   1747       with_offset ? Script::WITH_OFFSET : Script::NO_OFFSET;
   1748   return *GetJSPositionInfo(script_handle, position, offset_flag, isolate);
   1749 }
   1750 
   1751 // TODO(5530): Rename once conflicting function has been deleted.
   1752 RUNTIME_FUNCTION(Runtime_ScriptPositionInfo2) {
   1753   HandleScope scope(isolate);
   1754   DCHECK_EQ(3, args.length());
   1755   CONVERT_NUMBER_CHECKED(int32_t, scriptid, Int32, args[0]);
   1756   CONVERT_NUMBER_CHECKED(int32_t, position, Int32, args[1]);
   1757   CONVERT_BOOLEAN_ARG_CHECKED(with_offset, 2);
   1758 
   1759   Handle<Script> script;
   1760   CHECK(GetScriptById(isolate, scriptid, &script));
   1761 
   1762   const Script::OffsetFlag offset_flag =
   1763       with_offset ? Script::WITH_OFFSET : Script::NO_OFFSET;
   1764   return *GetJSPositionInfo(script, position, offset_flag, isolate);
   1765 }
   1766 
   1767 // Returns the given line as a string, or null if line is out of bounds.
   1768 // The parameter line is expected to include the script's line offset.
   1769 // TODO(5530): Remove once uses in debug.js are gone.
   1770 RUNTIME_FUNCTION(Runtime_ScriptSourceLine) {
   1771   HandleScope scope(isolate);
   1772   DCHECK_EQ(2, args.length());
   1773   CONVERT_ARG_CHECKED(JSValue, script, 0);
   1774   CONVERT_NUMBER_CHECKED(int32_t, line, Int32, args[1]);
   1775 
   1776   CHECK(script->value()->IsScript());
   1777   Handle<Script> script_handle = Handle<Script>(Script::cast(script->value()));
   1778 
   1779   if (script_handle->type() == Script::TYPE_WASM) {
   1780     // Return null for now; this function will disappear soon anyway.
   1781     return isolate->heap()->null_value();
   1782   }
   1783 
   1784   Script::InitLineEnds(script_handle);
   1785 
   1786   FixedArray* line_ends_array = FixedArray::cast(script_handle->line_ends());
   1787   const int line_count = line_ends_array->length();
   1788 
   1789   line -= script_handle->line_offset();
   1790   if (line < 0 || line_count <= line) {
   1791     return isolate->heap()->null_value();
   1792   }
   1793 
   1794   const int start =
   1795       (line == 0) ? 0 : Smi::cast(line_ends_array->get(line - 1))->value() + 1;
   1796   const int end = Smi::cast(line_ends_array->get(line))->value();
   1797 
   1798   Handle<String> source =
   1799       handle(String::cast(script_handle->source()), isolate);
   1800   Handle<String> str = isolate->factory()->NewSubString(source, start, end);
   1801 
   1802   return *str;
   1803 }
   1804 
   1805 // On function call, depending on circumstances, prepare for stepping in,
   1806 // or perform a side effect check.
   1807 RUNTIME_FUNCTION(Runtime_DebugOnFunctionCall) {
   1808   HandleScope scope(isolate);
   1809   DCHECK_EQ(1, args.length());
   1810   CONVERT_ARG_HANDLE_CHECKED(JSFunction, fun, 0);
   1811   if (isolate->debug()->last_step_action() >= StepIn) {
   1812     isolate->debug()->PrepareStepIn(fun);
   1813   }
   1814   if (isolate->needs_side_effect_check() &&
   1815       !isolate->debug()->PerformSideEffectCheck(fun)) {
   1816     return isolate->heap()->exception();
   1817   }
   1818   return isolate->heap()->undefined_value();
   1819 }
   1820 
   1821 // Set one shot breakpoints for the suspended generator object.
   1822 RUNTIME_FUNCTION(Runtime_DebugPrepareStepInSuspendedGenerator) {
   1823   HandleScope scope(isolate);
   1824   DCHECK_EQ(0, args.length());
   1825   isolate->debug()->PrepareStepInSuspendedGenerator();
   1826   return isolate->heap()->undefined_value();
   1827 }
   1828 
   1829 RUNTIME_FUNCTION(Runtime_DebugRecordGenerator) {
   1830   HandleScope scope(isolate);
   1831   DCHECK_EQ(1, args.length());
   1832   CONVERT_ARG_HANDLE_CHECKED(JSGeneratorObject, generator, 0);
   1833   CHECK(isolate->debug()->last_step_action() >= StepNext);
   1834   isolate->debug()->RecordGenerator(generator);
   1835   return isolate->heap()->undefined_value();
   1836 }
   1837 
   1838 RUNTIME_FUNCTION(Runtime_DebugPushPromise) {
   1839   DCHECK_EQ(1, args.length());
   1840   HandleScope scope(isolate);
   1841   CONVERT_ARG_HANDLE_CHECKED(JSObject, promise, 0);
   1842   isolate->PushPromise(promise);
   1843   return isolate->heap()->undefined_value();
   1844 }
   1845 
   1846 
   1847 RUNTIME_FUNCTION(Runtime_DebugPopPromise) {
   1848   DCHECK_EQ(0, args.length());
   1849   SealHandleScope shs(isolate);
   1850   isolate->PopPromise();
   1851   return isolate->heap()->undefined_value();
   1852 }
   1853 
   1854 RUNTIME_FUNCTION(Runtime_DebugAsyncFunctionPromiseCreated) {
   1855   DCHECK_EQ(1, args.length());
   1856   HandleScope scope(isolate);
   1857   CONVERT_ARG_HANDLE_CHECKED(JSObject, promise, 0);
   1858   isolate->PushPromise(promise);
   1859   int id = isolate->debug()->NextAsyncTaskId(promise);
   1860   Handle<Symbol> async_stack_id_symbol =
   1861       isolate->factory()->promise_async_stack_id_symbol();
   1862   JSObject::SetProperty(promise, async_stack_id_symbol,
   1863                         handle(Smi::FromInt(id), isolate), STRICT)
   1864       .Assert();
   1865   isolate->debug()->OnAsyncTaskEvent(debug::kDebugEnqueueAsyncFunction, id, 0);
   1866   return isolate->heap()->undefined_value();
   1867 }
   1868 
   1869 RUNTIME_FUNCTION(Runtime_DebugPromiseReject) {
   1870   HandleScope scope(isolate);
   1871   DCHECK_EQ(2, args.length());
   1872   CONVERT_ARG_HANDLE_CHECKED(JSPromise, rejected_promise, 0);
   1873   CONVERT_ARG_HANDLE_CHECKED(Object, value, 1);
   1874 
   1875   isolate->debug()->OnPromiseReject(rejected_promise, value);
   1876   return isolate->heap()->undefined_value();
   1877 }
   1878 
   1879 RUNTIME_FUNCTION(Runtime_DebugAsyncEventEnqueueRecurring) {
   1880   HandleScope scope(isolate);
   1881   DCHECK_EQ(2, args.length());
   1882   CONVERT_ARG_HANDLE_CHECKED(JSPromise, promise, 0);
   1883   CONVERT_SMI_ARG_CHECKED(status, 1);
   1884   if (isolate->debug()->is_active()) {
   1885     isolate->debug()->OnAsyncTaskEvent(
   1886         status == v8::Promise::kFulfilled ? debug::kDebugEnqueuePromiseResolve
   1887                                           : debug::kDebugEnqueuePromiseReject,
   1888         isolate->debug()->NextAsyncTaskId(promise), 0);
   1889   }
   1890   return isolate->heap()->undefined_value();
   1891 }
   1892 
   1893 RUNTIME_FUNCTION(Runtime_DebugIsActive) {
   1894   SealHandleScope shs(isolate);
   1895   return Smi::FromInt(isolate->debug()->is_active());
   1896 }
   1897 
   1898 RUNTIME_FUNCTION(Runtime_DebugBreakInOptimizedCode) {
   1899   UNIMPLEMENTED();
   1900   return NULL;
   1901 }
   1902 
   1903 RUNTIME_FUNCTION(Runtime_DebugCollectCoverage) {
   1904   HandleScope scope(isolate);
   1905   DCHECK_EQ(0, args.length());
   1906   // Collect coverage data.
   1907   std::unique_ptr<Coverage> coverage(Coverage::Collect(isolate, false));
   1908   Factory* factory = isolate->factory();
   1909   // Turn the returned data structure into JavaScript.
   1910   // Create an array of scripts.
   1911   int num_scripts = static_cast<int>(coverage->size());
   1912   // Prepare property keys.
   1913   Handle<FixedArray> scripts_array = factory->NewFixedArray(num_scripts);
   1914   Handle<String> script_string = factory->NewStringFromStaticChars("script");
   1915   Handle<String> start_string = factory->NewStringFromStaticChars("start");
   1916   Handle<String> end_string = factory->NewStringFromStaticChars("end");
   1917   Handle<String> count_string = factory->NewStringFromStaticChars("count");
   1918   for (int i = 0; i < num_scripts; i++) {
   1919     const auto& script_data = coverage->at(i);
   1920     HandleScope inner_scope(isolate);
   1921     int num_functions = static_cast<int>(script_data.functions.size());
   1922     Handle<FixedArray> functions_array = factory->NewFixedArray(num_functions);
   1923     for (int j = 0; j < num_functions; j++) {
   1924       const auto& function_data = script_data.functions[j];
   1925       Handle<JSObject> range_obj = factory->NewJSObjectWithNullProto();
   1926       JSObject::AddProperty(range_obj, start_string,
   1927                             factory->NewNumberFromInt(function_data.start),
   1928                             NONE);
   1929       JSObject::AddProperty(range_obj, end_string,
   1930                             factory->NewNumberFromInt(function_data.end), NONE);
   1931       JSObject::AddProperty(range_obj, count_string,
   1932                             factory->NewNumberFromUint(function_data.count),
   1933                             NONE);
   1934       functions_array->set(j, *range_obj);
   1935     }
   1936     Handle<JSArray> script_obj =
   1937         factory->NewJSArrayWithElements(functions_array, FAST_ELEMENTS);
   1938     Handle<JSObject> wrapper = Script::GetWrapper(script_data.script);
   1939     JSObject::AddProperty(script_obj, script_string, wrapper, NONE);
   1940     scripts_array->set(i, *script_obj);
   1941   }
   1942   return *factory->NewJSArrayWithElements(scripts_array, FAST_ELEMENTS);
   1943 }
   1944 
   1945 RUNTIME_FUNCTION(Runtime_DebugTogglePreciseCoverage) {
   1946   SealHandleScope shs(isolate);
   1947   CONVERT_BOOLEAN_ARG_CHECKED(enable, 0);
   1948   Coverage::TogglePrecise(isolate, enable);
   1949   return isolate->heap()->undefined_value();
   1950 }
   1951 
   1952 }  // namespace internal
   1953 }  // namespace v8
   1954