You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
82 lines
3.0 KiB
82 lines
3.0 KiB
// Copyright 2014 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_LIBPLATFORM_LIBPLATFORM_H_ |
|
#define V8_LIBPLATFORM_LIBPLATFORM_H_ |
|
|
|
#include "libplatform/libplatform-export.h" |
|
#include "libplatform/v8-tracing.h" |
|
#include "v8-platform.h" // NOLINT(build/include) |
|
#include "v8config.h" // NOLINT(build/include) |
|
|
|
namespace v8 { |
|
namespace platform { |
|
|
|
enum class IdleTaskSupport { kDisabled, kEnabled }; |
|
enum class InProcessStackDumping { kDisabled, kEnabled }; |
|
|
|
enum class MessageLoopBehavior : bool { |
|
kDoNotWait = false, |
|
kWaitForWork = true |
|
}; |
|
|
|
/** |
|
* Returns a new instance of the default v8::Platform implementation. |
|
* |
|
* The caller will take ownership of the returned pointer. |thread_pool_size| |
|
* is the number of worker threads to allocate for background jobs. If a value |
|
* of zero is passed, a suitable default based on the current number of |
|
* processors online will be chosen. |
|
* If |idle_task_support| is enabled then the platform will accept idle |
|
* tasks (IdleTasksEnabled will return true) and will rely on the embedder |
|
* calling v8::platform::RunIdleTasks to process the idle tasks. |
|
* If |tracing_controller| is nullptr, the default platform will create a |
|
* v8::platform::TracingController instance and use it. |
|
*/ |
|
V8_PLATFORM_EXPORT std::unique_ptr<v8::Platform> NewDefaultPlatform( |
|
int thread_pool_size = 0, |
|
IdleTaskSupport idle_task_support = IdleTaskSupport::kDisabled, |
|
InProcessStackDumping in_process_stack_dumping = |
|
InProcessStackDumping::kDisabled, |
|
std::unique_ptr<v8::TracingController> tracing_controller = {}); |
|
|
|
/** |
|
* Pumps the message loop for the given isolate. |
|
* |
|
* The caller has to make sure that this is called from the right thread. |
|
* Returns true if a task was executed, and false otherwise. Unless requested |
|
* through the |behavior| parameter, this call does not block if no task is |
|
* pending. The |platform| has to be created using |NewDefaultPlatform|. |
|
*/ |
|
V8_PLATFORM_EXPORT bool PumpMessageLoop( |
|
v8::Platform* platform, v8::Isolate* isolate, |
|
MessageLoopBehavior behavior = MessageLoopBehavior::kDoNotWait); |
|
|
|
/** |
|
* Runs pending idle tasks for at most |idle_time_in_seconds| seconds. |
|
* |
|
* The caller has to make sure that this is called from the right thread. |
|
* This call does not block if no task is pending. The |platform| has to be |
|
* created using |NewDefaultPlatform|. |
|
*/ |
|
V8_PLATFORM_EXPORT void RunIdleTasks(v8::Platform* platform, |
|
v8::Isolate* isolate, |
|
double idle_time_in_seconds); |
|
|
|
/** |
|
* Attempts to set the tracing controller for the given platform. |
|
* |
|
* The |platform| has to be created using |NewDefaultPlatform|. |
|
* |
|
*/ |
|
V8_PLATFORM_EXPORT V8_DEPRECATE_SOON( |
|
"Access the DefaultPlatform directly", |
|
void SetTracingController( |
|
v8::Platform* platform, |
|
v8::platform::tracing::TracingController* tracing_controller)); |
|
|
|
} // namespace platform |
|
} // namespace v8 |
|
|
|
#endif // V8_LIBPLATFORM_LIBPLATFORM_H_
|
|
|