// Copyright 2018 the V8 project authors. All rights reserved.
|
// Use of this source code is governed by a BSD-style license that can be
|
// found in the LICENSE file.
|
|
#ifndef V8_OBJECTS_JS_GENERATOR_H_
|
#define V8_OBJECTS_JS_GENERATOR_H_
|
|
#include "src/objects.h"
|
|
// Has to be the last include (doesn't have include guards):
|
#include "src/objects/object-macros.h"
|
|
namespace v8 {
|
namespace internal {
|
|
class JSGeneratorObject : public JSObject {
|
public:
|
// [function]: The function corresponding to this generator object.
|
DECL_ACCESSORS(function, JSFunction)
|
|
// [context]: The context of the suspended computation.
|
DECL_ACCESSORS(context, Context)
|
|
// [receiver]: The receiver of the suspended computation.
|
DECL_ACCESSORS(receiver, Object)
|
|
// [input_or_debug_pos]
|
// For executing generators: the most recent input value.
|
// For suspended generators: debug information (bytecode offset).
|
// There is currently no need to remember the most recent input value for a
|
// suspended generator.
|
DECL_ACCESSORS(input_or_debug_pos, Object)
|
|
// [resume_mode]: The most recent resume mode.
|
enum ResumeMode { kNext, kReturn, kThrow };
|
DECL_INT_ACCESSORS(resume_mode)
|
|
// [continuation]
|
//
|
// A positive value indicates a suspended generator. The special
|
// kGeneratorExecuting and kGeneratorClosed values indicate that a generator
|
// cannot be resumed.
|
inline int continuation() const;
|
inline void set_continuation(int continuation);
|
inline bool is_closed() const;
|
inline bool is_executing() const;
|
inline bool is_suspended() const;
|
|
// For suspended generators: the source position at which the generator
|
// is suspended.
|
int source_position() const;
|
|
// [parameters_and_registers]: Saved interpreter register file.
|
DECL_ACCESSORS(parameters_and_registers, FixedArray)
|
|
DECL_CAST(JSGeneratorObject)
|
|
// Dispatched behavior.
|
DECL_PRINTER(JSGeneratorObject)
|
DECL_VERIFIER(JSGeneratorObject)
|
|
// Magic sentinel values for the continuation.
|
static const int kGeneratorExecuting = -2;
|
static const int kGeneratorClosed = -1;
|
|
// Layout description.
|
static const int kFunctionOffset = JSObject::kHeaderSize;
|
static const int kContextOffset = kFunctionOffset + kPointerSize;
|
static const int kReceiverOffset = kContextOffset + kPointerSize;
|
static const int kInputOrDebugPosOffset = kReceiverOffset + kPointerSize;
|
static const int kResumeModeOffset = kInputOrDebugPosOffset + kPointerSize;
|
static const int kContinuationOffset = kResumeModeOffset + kPointerSize;
|
static const int kParametersAndRegistersOffset =
|
kContinuationOffset + kPointerSize;
|
static const int kSize = kParametersAndRegistersOffset + kPointerSize;
|
|
private:
|
DISALLOW_IMPLICIT_CONSTRUCTORS(JSGeneratorObject);
|
};
|
|
class JSAsyncGeneratorObject : public JSGeneratorObject {
|
public:
|
DECL_CAST(JSAsyncGeneratorObject)
|
|
// Dispatched behavior.
|
DECL_VERIFIER(JSAsyncGeneratorObject)
|
|
// [queue]
|
// Pointer to the head of a singly linked list of AsyncGeneratorRequest, or
|
// undefined.
|
DECL_ACCESSORS(queue, HeapObject)
|
|
// [is_awaiting]
|
// Whether or not the generator is currently awaiting.
|
DECL_INT_ACCESSORS(is_awaiting)
|
|
// Layout description.
|
static const int kQueueOffset = JSGeneratorObject::kSize;
|
static const int kIsAwaitingOffset = kQueueOffset + kPointerSize;
|
static const int kSize = kIsAwaitingOffset + kPointerSize;
|
|
private:
|
DISALLOW_IMPLICIT_CONSTRUCTORS(JSAsyncGeneratorObject);
|
};
|
|
} // namespace internal
|
} // namespace v8
|
|
#include "src/objects/object-macros-undef.h"
|
|
#endif // V8_OBJECTS_JS_GENERATOR_H_
|
