78387ca75d
- Introduce v8::ScriptCompiler::CompileFunction - Deprecate v8::ScriptCompiler::CompileFunctionInContext - Add v8::Function::GetUnboundScript - Add v8::Script::GetResourceName The ScriptOrModule out-parameter is only used by NodeJS since we don't allow arbitrary objects has host-defined options and they need a way to keep the options alive. This CL deprecates the out-parameter and adds helper methods to address the most common use-cases. The final fix still requires more fundamental changes on how host-defined options are handled. Bug: chromium:1244145 Change-Id: Id29de53521ad626c41391b8300146ee37a1b8a51 Reviewed-on: https://chromium-review.googlesource.com/c/v8/v8/+/3245117 Reviewed-by: Victor Gomes <victorgomes@chromium.org> Reviewed-by: Jakob Gruber <jgruber@chromium.org> Commit-Queue: Jakob Gruber <jgruber@chromium.org> Auto-Submit: Camillo Bruni <cbruni@chromium.org> Cr-Commit-Position: refs/heads/main@{#77564}
126 lines
3.9 KiB
C++
126 lines
3.9 KiB
C++
// Copyright 2021 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 INCLUDE_V8_FUNCTION_H_
|
|
#define INCLUDE_V8_FUNCTION_H_
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#include "v8-function-callback.h" // NOLINT(build/include_directory)
|
|
#include "v8-local-handle.h" // NOLINT(build/include_directory)
|
|
#include "v8-message.h" // NOLINT(build/include_directory)
|
|
#include "v8-object.h" // NOLINT(build/include_directory)
|
|
#include "v8-template.h" // NOLINT(build/include_directory)
|
|
#include "v8config.h" // NOLINT(build/include_directory)
|
|
|
|
namespace v8 {
|
|
|
|
class Context;
|
|
class UnboundScript;
|
|
|
|
/**
|
|
* A JavaScript function object (ECMA-262, 15.3).
|
|
*/
|
|
class V8_EXPORT Function : public Object {
|
|
public:
|
|
/**
|
|
* Create a function in the current execution context
|
|
* for a given FunctionCallback.
|
|
*/
|
|
static MaybeLocal<Function> New(
|
|
Local<Context> context, FunctionCallback callback,
|
|
Local<Value> data = Local<Value>(), int length = 0,
|
|
ConstructorBehavior behavior = ConstructorBehavior::kAllow,
|
|
SideEffectType side_effect_type = SideEffectType::kHasSideEffect);
|
|
|
|
V8_WARN_UNUSED_RESULT MaybeLocal<Object> NewInstance(
|
|
Local<Context> context, int argc, Local<Value> argv[]) const;
|
|
|
|
V8_WARN_UNUSED_RESULT MaybeLocal<Object> NewInstance(
|
|
Local<Context> context) const {
|
|
return NewInstance(context, 0, nullptr);
|
|
}
|
|
|
|
/**
|
|
* When side effect checks are enabled, passing kHasNoSideEffect allows the
|
|
* constructor to be invoked without throwing. Calls made within the
|
|
* constructor are still checked.
|
|
*/
|
|
V8_WARN_UNUSED_RESULT MaybeLocal<Object> NewInstanceWithSideEffectType(
|
|
Local<Context> context, int argc, Local<Value> argv[],
|
|
SideEffectType side_effect_type = SideEffectType::kHasSideEffect) const;
|
|
|
|
V8_WARN_UNUSED_RESULT MaybeLocal<Value> Call(Local<Context> context,
|
|
Local<Value> recv, int argc,
|
|
Local<Value> argv[]);
|
|
|
|
void SetName(Local<String> name);
|
|
Local<Value> GetName() const;
|
|
|
|
MaybeLocal<UnboundScript> GetUnboundScript() const;
|
|
|
|
/**
|
|
* Name inferred from variable or property assignment of this function.
|
|
* Used to facilitate debugging and profiling of JavaScript code written
|
|
* in an OO style, where many functions are anonymous but are assigned
|
|
* to object properties.
|
|
*/
|
|
Local<Value> GetInferredName() const;
|
|
|
|
/**
|
|
* displayName if it is set, otherwise name if it is configured, otherwise
|
|
* function name, otherwise inferred name.
|
|
*/
|
|
Local<Value> GetDebugName() const;
|
|
|
|
/**
|
|
* Returns zero based line number of function body and
|
|
* kLineOffsetNotFound if no information available.
|
|
*/
|
|
int GetScriptLineNumber() const;
|
|
/**
|
|
* Returns zero based column number of function body and
|
|
* kLineOffsetNotFound if no information available.
|
|
*/
|
|
int GetScriptColumnNumber() const;
|
|
|
|
/**
|
|
* Returns scriptId.
|
|
*/
|
|
int ScriptId() const;
|
|
|
|
/**
|
|
* Returns the original function if this function is bound, else returns
|
|
* v8::Undefined.
|
|
*/
|
|
Local<Value> GetBoundFunction() const;
|
|
|
|
/**
|
|
* Calls builtin Function.prototype.toString on this function.
|
|
* This is different from Value::ToString() that may call a user-defined
|
|
* toString() function, and different than Object::ObjectProtoToString() which
|
|
* always serializes "[object Function]".
|
|
*/
|
|
V8_WARN_UNUSED_RESULT MaybeLocal<String> FunctionProtoToString(
|
|
Local<Context> context);
|
|
|
|
ScriptOrigin GetScriptOrigin() const;
|
|
V8_INLINE static Function* Cast(Value* value) {
|
|
#ifdef V8_ENABLE_CHECKS
|
|
CheckCast(value);
|
|
#endif
|
|
return static_cast<Function*>(value);
|
|
}
|
|
|
|
static const int kLineOffsetNotFound;
|
|
|
|
private:
|
|
Function();
|
|
static void CheckCast(Value* obj);
|
|
};
|
|
} // namespace v8
|
|
|
|
#endif // INCLUDE_V8_FUNCTION_H_
|