v8
8.4.371 (node 14.15.5)
V8 is Google's open source JavaScript engine
libplatform.h
Go to the documentation of this file.
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
#
ifndef
V8_LIBPLATFORM_LIBPLATFORM_H_
6
#
define
V8_LIBPLATFORM_LIBPLATFORM_H_
7
8
#
include
<
memory
>
9
10
#
include
"libplatform/libplatform-export.h"
11
#
include
"libplatform/v8-tracing.h"
12
#
include
"v8-platform.h"
// NOLINT(build/include_directory)
13
#
include
"v8config.h"
// NOLINT(build/include_directory)
14
15
namespace
v8
{
16
namespace
platform
{
17
18
enum
class
IdleTaskSupport
{
kDisabled
,
kEnabled
};
19
enum
class
InProcessStackDumping
{
kDisabled
,
kEnabled
};
20
21
enum
class
MessageLoopBehavior
:
bool
{
22
kDoNotWait
=
false
,
23
kWaitForWork
=
true
24
};
25
26
/**
27
* Returns a new instance of the default v8::Platform implementation.
28
*
29
* The caller will take ownership of the returned pointer. |thread_pool_size|
30
* is the number of worker threads to allocate for background jobs. If a value
31
* of zero is passed, a suitable default based on the current number of
32
* processors online will be chosen.
33
* If |idle_task_support| is enabled then the platform will accept idle
34
* tasks (IdleTasksEnabled will return true) and will rely on the embedder
35
* calling v8::platform::RunIdleTasks to process the idle tasks.
36
* If |tracing_controller| is nullptr, the default platform will create a
37
* v8::platform::TracingController instance and use it.
38
*/
39
V8_PLATFORM_EXPORT
std::unique_ptr<
v8
::
Platform
>
NewDefaultPlatform
(
40
int
thread_pool_size = 0,
41
IdleTaskSupport
idle_task_support =
IdleTaskSupport
::
kDisabled
,
42
InProcessStackDumping
in_process_stack_dumping =
43
InProcessStackDumping
::
kDisabled
,
44
std::unique_ptr<
v8
::
TracingController
> tracing_controller = {});
45
46
/**
47
* Pumps the message loop for the given isolate.
48
*
49
* The caller has to make sure that this is called from the right thread.
50
* Returns true if a task was executed, and false otherwise. If the call to
51
* PumpMessageLoop is nested within another call to PumpMessageLoop, only
52
* nestable tasks may run. Otherwise, any task may run. Unless requested through
53
* the |behavior| parameter, this call does not block if no task is pending. The
54
* |platform| has to be created using |NewDefaultPlatform|.
55
*/
56
V8_PLATFORM_EXPORT
bool
PumpMessageLoop
(
57
v8
::
Platform
* platform,
v8
::
Isolate
* isolate,
58
MessageLoopBehavior
behavior =
MessageLoopBehavior
::
kDoNotWait
);
59
60
/**
61
* Runs pending idle tasks for at most |idle_time_in_seconds| seconds.
62
*
63
* The caller has to make sure that this is called from the right thread.
64
* This call does not block if no task is pending. The |platform| has to be
65
* created using |NewDefaultPlatform|.
66
*/
67
V8_PLATFORM_EXPORT
void
RunIdleTasks
(
v8
::
Platform
* platform,
68
v8
::
Isolate
* isolate,
69
double
idle_time_in_seconds);
70
71
/**
72
* Attempts to set the tracing controller for the given platform.
73
*
74
* The |platform| has to be created using |NewDefaultPlatform|.
75
*
76
*/
77
V8_DEPRECATE_SOON
(
"Access the DefaultPlatform directly"
)
78
V8_PLATFORM_EXPORT
void
SetTracingController
(
79
v8
::
Platform
* platform,
80
v8
::
platform
::
tracing
::
TracingController
* tracing_controller);
81
82
}
// namespace platform
83
}
// namespace v8
84
85
#
endif
// V8_LIBPLATFORM_LIBPLATFORM_H_
include
libplatform
libplatform.h
Generated on Fri Oct 29 2021 20:07:27 for v8 by
1.9.1