libv8-node 16.10.0.0-x86_64-linux-musl → 18.8.0.0-x86_64-linux-musl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. checksums.yaml +4 -4
  2. data/ext/libv8-node/paths.rb +5 -1
  3. data/lib/libv8/node/version.rb +3 -3
  4. data/vendor/v8/include/cppgc/allocation.h +100 -22
  5. data/vendor/v8/include/cppgc/cross-thread-persistent.h +114 -33
  6. data/vendor/v8/include/cppgc/default-platform.h +2 -10
  7. data/vendor/v8/include/cppgc/explicit-management.h +22 -4
  8. data/vendor/v8/include/cppgc/garbage-collected.h +15 -26
  9. data/vendor/v8/include/cppgc/heap-consistency.h +30 -0
  10. data/vendor/v8/include/cppgc/heap-state.h +12 -0
  11. data/vendor/v8/include/cppgc/heap.h +7 -2
  12. data/vendor/v8/include/cppgc/internal/api-constants.h +8 -0
  13. data/vendor/v8/include/cppgc/internal/caged-heap-local-data.h +25 -14
  14. data/vendor/v8/include/cppgc/internal/finalizer-trait.h +4 -1
  15. data/vendor/v8/include/cppgc/internal/gc-info.h +90 -10
  16. data/vendor/v8/include/cppgc/internal/logging.h +3 -3
  17. data/vendor/v8/include/cppgc/internal/name-trait.h +11 -0
  18. data/vendor/v8/include/cppgc/internal/persistent-node.h +73 -29
  19. data/vendor/v8/include/cppgc/internal/pointer-policies.h +26 -15
  20. data/vendor/v8/include/cppgc/internal/write-barrier.h +62 -23
  21. data/vendor/v8/include/cppgc/liveness-broker.h +4 -1
  22. data/vendor/v8/include/cppgc/member.h +7 -2
  23. data/vendor/v8/include/cppgc/persistent.h +38 -33
  24. data/vendor/v8/include/cppgc/platform.h +4 -1
  25. data/vendor/v8/include/cppgc/prefinalizer.h +35 -12
  26. data/vendor/v8/include/cppgc/testing.h +9 -2
  27. data/vendor/v8/include/cppgc/type-traits.h +6 -13
  28. data/vendor/v8/include/cppgc/visitor.h +9 -7
  29. data/vendor/v8/include/libplatform/libplatform.h +0 -11
  30. data/vendor/v8/include/libplatform/v8-tracing.h +0 -1
  31. data/vendor/v8/include/v8-array-buffer.h +445 -0
  32. data/vendor/v8/include/v8-callbacks.h +397 -0
  33. data/vendor/v8/include/v8-container.h +129 -0
  34. data/vendor/v8/include/v8-context.h +407 -0
  35. data/vendor/v8/include/v8-cppgc.h +21 -128
  36. data/vendor/v8/include/v8-data.h +80 -0
  37. data/vendor/v8/include/v8-date.h +43 -0
  38. data/vendor/v8/include/v8-debug.h +168 -0
  39. data/vendor/v8/include/v8-embedder-heap.h +218 -0
  40. data/vendor/v8/include/v8-embedder-state-scope.h +51 -0
  41. data/vendor/v8/include/v8-exception.h +217 -0
  42. data/vendor/v8/include/v8-extension.h +62 -0
  43. data/vendor/v8/include/v8-external.h +37 -0
  44. data/vendor/v8/include/v8-fast-api-calls.h +172 -24
  45. data/vendor/v8/include/v8-forward.h +81 -0
  46. data/vendor/v8/include/v8-function-callback.h +475 -0
  47. data/vendor/v8/include/v8-function.h +125 -0
  48. data/vendor/v8/include/v8-initialization.h +315 -0
  49. data/vendor/v8/include/v8-inspector.h +56 -28
  50. data/vendor/v8/include/v8-internal.h +217 -55
  51. data/vendor/v8/include/v8-isolate.h +1709 -0
  52. data/vendor/v8/include/v8-json.h +47 -0
  53. data/vendor/v8/include/v8-local-handle.h +455 -0
  54. data/vendor/v8/include/v8-locker.h +149 -0
  55. data/vendor/v8/include/v8-maybe.h +137 -0
  56. data/vendor/v8/include/v8-memory-span.h +43 -0
  57. data/vendor/v8/include/v8-message.h +216 -0
  58. data/vendor/v8/include/v8-metrics.h +69 -16
  59. data/vendor/v8/include/v8-microtask-queue.h +152 -0
  60. data/vendor/v8/include/v8-microtask.h +28 -0
  61. data/vendor/v8/include/v8-object.h +775 -0
  62. data/vendor/v8/include/v8-persistent-handle.h +590 -0
  63. data/vendor/v8/include/v8-platform.h +400 -17
  64. data/vendor/v8/include/v8-primitive-object.h +118 -0
  65. data/vendor/v8/include/v8-primitive.h +866 -0
  66. data/vendor/v8/include/v8-profiler.h +88 -13
  67. data/vendor/v8/include/v8-promise.h +174 -0
  68. data/vendor/v8/include/v8-proxy.h +50 -0
  69. data/vendor/v8/include/v8-regexp.h +105 -0
  70. data/vendor/v8/include/v8-script.h +747 -0
  71. data/vendor/v8/include/v8-snapshot.h +196 -0
  72. data/vendor/v8/include/v8-statistics.h +217 -0
  73. data/vendor/v8/include/v8-template.h +1079 -0
  74. data/vendor/v8/include/v8-traced-handle.h +420 -0
  75. data/vendor/v8/include/v8-typed-array.h +282 -0
  76. data/vendor/v8/include/v8-unwinder-state.h +4 -3
  77. data/vendor/v8/include/v8-unwinder.h +132 -0
  78. data/vendor/v8/include/v8-util.h +7 -1
  79. data/vendor/v8/include/v8-value-serializer-version.h +1 -1
  80. data/vendor/v8/include/v8-value-serializer.h +279 -0
  81. data/vendor/v8/include/v8-value.h +526 -0
  82. data/vendor/v8/include/v8-version.h +4 -4
  83. data/vendor/v8/include/v8-wasm.h +257 -0
  84. data/vendor/v8/include/v8-weak-callback-info.h +87 -0
  85. data/vendor/v8/include/v8.h +41 -12601
  86. data/vendor/v8/include/v8config.h +102 -12
  87. data/vendor/v8/x86_64-linux-musl/libv8/obj/libv8_monolith.a +0 -0
  88. metadata +50 -8
  89. data/vendor/v8/include/cppgc/internal/prefinalizer-handler.h +0 -30
@@ -0,0 +1,747 @@
1
+ // Copyright 2021 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 INCLUDE_V8_SCRIPT_H_
6
+ #define INCLUDE_V8_SCRIPT_H_
7
+
8
+ #include <stddef.h>
9
+ #include <stdint.h>
10
+
11
+ #include <memory>
12
+ #include <vector>
13
+
14
+ #include "v8-data.h" // NOLINT(build/include_directory)
15
+ #include "v8-local-handle.h" // NOLINT(build/include_directory)
16
+ #include "v8-maybe.h" // NOLINT(build/include_directory)
17
+ #include "v8-message.h" // NOLINT(build/include_directory)
18
+ #include "v8config.h" // NOLINT(build/include_directory)
19
+
20
+ namespace v8 {
21
+
22
+ class Function;
23
+ class Object;
24
+ class PrimitiveArray;
25
+ class Script;
26
+
27
+ namespace internal {
28
+ class BackgroundDeserializeTask;
29
+ struct ScriptStreamingData;
30
+ } // namespace internal
31
+
32
+ /**
33
+ * A container type that holds relevant metadata for module loading.
34
+ *
35
+ * This is passed back to the embedder as part of
36
+ * HostImportModuleDynamicallyCallback for module loading.
37
+ */
38
+ class V8_EXPORT ScriptOrModule {
39
+ public:
40
+ /**
41
+ * The name that was passed by the embedder as ResourceName to the
42
+ * ScriptOrigin. This can be either a v8::String or v8::Undefined.
43
+ */
44
+ Local<Value> GetResourceName();
45
+
46
+ /**
47
+ * The options that were passed by the embedder as HostDefinedOptions to
48
+ * the ScriptOrigin.
49
+ */
50
+ V8_DEPRECATED("Use HostDefinedOptions")
51
+ Local<PrimitiveArray> GetHostDefinedOptions();
52
+ Local<Data> HostDefinedOptions();
53
+ };
54
+
55
+ /**
56
+ * A compiled JavaScript script, not yet tied to a Context.
57
+ */
58
+ class V8_EXPORT UnboundScript {
59
+ public:
60
+ /**
61
+ * Binds the script to the currently entered context.
62
+ */
63
+ Local<Script> BindToCurrentContext();
64
+
65
+ int GetId() const;
66
+ Local<Value> GetScriptName();
67
+
68
+ /**
69
+ * Data read from magic sourceURL comments.
70
+ */
71
+ Local<Value> GetSourceURL();
72
+ /**
73
+ * Data read from magic sourceMappingURL comments.
74
+ */
75
+ Local<Value> GetSourceMappingURL();
76
+
77
+ /**
78
+ * Returns zero based line number of the code_pos location in the script.
79
+ * -1 will be returned if no information available.
80
+ */
81
+ int GetLineNumber(int code_pos);
82
+
83
+ static const int kNoScriptId = 0;
84
+ };
85
+
86
+ /**
87
+ * A compiled JavaScript module, not yet tied to a Context.
88
+ */
89
+ class V8_EXPORT UnboundModuleScript : public Data {
90
+ // Only used as a container for code caching.
91
+ };
92
+
93
+ /**
94
+ * A location in JavaScript source.
95
+ */
96
+ class V8_EXPORT Location {
97
+ public:
98
+ int GetLineNumber() { return line_number_; }
99
+ int GetColumnNumber() { return column_number_; }
100
+
101
+ Location(int line_number, int column_number)
102
+ : line_number_(line_number), column_number_(column_number) {}
103
+
104
+ private:
105
+ int line_number_;
106
+ int column_number_;
107
+ };
108
+
109
+ class V8_EXPORT ModuleRequest : public Data {
110
+ public:
111
+ /**
112
+ * Returns the module specifier for this ModuleRequest.
113
+ */
114
+ Local<String> GetSpecifier() const;
115
+
116
+ /**
117
+ * Returns the source code offset of this module request.
118
+ * Use Module::SourceOffsetToLocation to convert this to line/column numbers.
119
+ */
120
+ int GetSourceOffset() const;
121
+
122
+ /**
123
+ * Contains the import assertions for this request in the form:
124
+ * [key1, value1, source_offset1, key2, value2, source_offset2, ...].
125
+ * The keys and values are of type v8::String, and the source offsets are of
126
+ * type Int32. Use Module::SourceOffsetToLocation to convert the source
127
+ * offsets to Locations with line/column numbers.
128
+ *
129
+ * All assertions present in the module request will be supplied in this
130
+ * list, regardless of whether they are supported by the host. Per
131
+ * https://tc39.es/proposal-import-assertions/#sec-hostgetsupportedimportassertions,
132
+ * hosts are expected to ignore assertions that they do not support (as
133
+ * opposed to, for example, triggering an error if an unsupported assertion is
134
+ * present).
135
+ */
136
+ Local<FixedArray> GetImportAssertions() const;
137
+
138
+ V8_INLINE static ModuleRequest* Cast(Data* data);
139
+
140
+ private:
141
+ static void CheckCast(Data* obj);
142
+ };
143
+
144
+ /**
145
+ * A compiled JavaScript module.
146
+ */
147
+ class V8_EXPORT Module : public Data {
148
+ public:
149
+ /**
150
+ * The different states a module can be in.
151
+ *
152
+ * This corresponds to the states used in ECMAScript except that "evaluated"
153
+ * is split into kEvaluated and kErrored, indicating success and failure,
154
+ * respectively.
155
+ */
156
+ enum Status {
157
+ kUninstantiated,
158
+ kInstantiating,
159
+ kInstantiated,
160
+ kEvaluating,
161
+ kEvaluated,
162
+ kErrored
163
+ };
164
+
165
+ /**
166
+ * Returns the module's current status.
167
+ */
168
+ Status GetStatus() const;
169
+
170
+ /**
171
+ * For a module in kErrored status, this returns the corresponding exception.
172
+ */
173
+ Local<Value> GetException() const;
174
+
175
+ /**
176
+ * Returns the ModuleRequests for this module.
177
+ */
178
+ Local<FixedArray> GetModuleRequests() const;
179
+
180
+ /**
181
+ * For the given source text offset in this module, returns the corresponding
182
+ * Location with line and column numbers.
183
+ */
184
+ Location SourceOffsetToLocation(int offset) const;
185
+
186
+ /**
187
+ * Returns the identity hash for this object.
188
+ */
189
+ int GetIdentityHash() const;
190
+
191
+ using ResolveModuleCallback = MaybeLocal<Module> (*)(
192
+ Local<Context> context, Local<String> specifier,
193
+ Local<FixedArray> import_assertions, Local<Module> referrer);
194
+
195
+ /**
196
+ * Instantiates the module and its dependencies.
197
+ *
198
+ * Returns an empty Maybe<bool> if an exception occurred during
199
+ * instantiation. (In the case where the callback throws an exception, that
200
+ * exception is propagated.)
201
+ */
202
+ V8_WARN_UNUSED_RESULT Maybe<bool> InstantiateModule(
203
+ Local<Context> context, ResolveModuleCallback callback);
204
+
205
+ /**
206
+ * Evaluates the module and its dependencies.
207
+ *
208
+ * If status is kInstantiated, run the module's code and return a Promise
209
+ * object. On success, set status to kEvaluated and resolve the Promise with
210
+ * the completion value; on failure, set status to kErrored and reject the
211
+ * Promise with the error.
212
+ *
213
+ * If IsGraphAsync() is false, the returned Promise is settled.
214
+ */
215
+ V8_WARN_UNUSED_RESULT MaybeLocal<Value> Evaluate(Local<Context> context);
216
+
217
+ /**
218
+ * Returns the namespace object of this module.
219
+ *
220
+ * The module's status must be at least kInstantiated.
221
+ */
222
+ Local<Value> GetModuleNamespace();
223
+
224
+ /**
225
+ * Returns the corresponding context-unbound module script.
226
+ *
227
+ * The module must be unevaluated, i.e. its status must not be kEvaluating,
228
+ * kEvaluated or kErrored.
229
+ */
230
+ Local<UnboundModuleScript> GetUnboundModuleScript();
231
+
232
+ /**
233
+ * Returns the underlying script's id.
234
+ *
235
+ * The module must be a SourceTextModule and must not have a kErrored status.
236
+ */
237
+ int ScriptId() const;
238
+
239
+ /**
240
+ * Returns whether this module or any of its requested modules is async,
241
+ * i.e. contains top-level await.
242
+ *
243
+ * The module's status must be at least kInstantiated.
244
+ */
245
+ bool IsGraphAsync() const;
246
+
247
+ /**
248
+ * Returns whether the module is a SourceTextModule.
249
+ */
250
+ bool IsSourceTextModule() const;
251
+
252
+ /**
253
+ * Returns whether the module is a SyntheticModule.
254
+ */
255
+ bool IsSyntheticModule() const;
256
+
257
+ /*
258
+ * Callback defined in the embedder. This is responsible for setting
259
+ * the module's exported values with calls to SetSyntheticModuleExport().
260
+ * The callback must return a resolved Promise to indicate success (where no
261
+ * exception was thrown) and return an empy MaybeLocal to indicate falure
262
+ * (where an exception was thrown).
263
+ */
264
+ using SyntheticModuleEvaluationSteps =
265
+ MaybeLocal<Value> (*)(Local<Context> context, Local<Module> module);
266
+
267
+ /**
268
+ * Creates a new SyntheticModule with the specified export names, where
269
+ * evaluation_steps will be executed upon module evaluation.
270
+ * export_names must not contain duplicates.
271
+ * module_name is used solely for logging/debugging and doesn't affect module
272
+ * behavior.
273
+ */
274
+ static Local<Module> CreateSyntheticModule(
275
+ Isolate* isolate, Local<String> module_name,
276
+ const std::vector<Local<String>>& export_names,
277
+ SyntheticModuleEvaluationSteps evaluation_steps);
278
+
279
+ /**
280
+ * Set this module's exported value for the name export_name to the specified
281
+ * export_value. This method must be called only on Modules created via
282
+ * CreateSyntheticModule. An error will be thrown if export_name is not one
283
+ * of the export_names that were passed in that CreateSyntheticModule call.
284
+ * Returns Just(true) on success, Nothing<bool>() if an error was thrown.
285
+ */
286
+ V8_WARN_UNUSED_RESULT Maybe<bool> SetSyntheticModuleExport(
287
+ Isolate* isolate, Local<String> export_name, Local<Value> export_value);
288
+
289
+ V8_INLINE static Module* Cast(Data* data);
290
+
291
+ private:
292
+ static void CheckCast(Data* obj);
293
+ };
294
+
295
+ /**
296
+ * A compiled JavaScript script, tied to a Context which was active when the
297
+ * script was compiled.
298
+ */
299
+ class V8_EXPORT Script {
300
+ public:
301
+ /**
302
+ * A shorthand for ScriptCompiler::Compile().
303
+ */
304
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Script> Compile(
305
+ Local<Context> context, Local<String> source,
306
+ ScriptOrigin* origin = nullptr);
307
+
308
+ /**
309
+ * Runs the script returning the resulting value. It will be run in the
310
+ * context in which it was created (ScriptCompiler::CompileBound or
311
+ * UnboundScript::BindToCurrentContext()).
312
+ */
313
+ V8_WARN_UNUSED_RESULT MaybeLocal<Value> Run(Local<Context> context);
314
+ V8_WARN_UNUSED_RESULT MaybeLocal<Value> Run(Local<Context> context,
315
+ Local<Data> host_defined_options);
316
+
317
+ /**
318
+ * Returns the corresponding context-unbound script.
319
+ */
320
+ Local<UnboundScript> GetUnboundScript();
321
+
322
+ /**
323
+ * The name that was passed by the embedder as ResourceName to the
324
+ * ScriptOrigin. This can be either a v8::String or v8::Undefined.
325
+ */
326
+ Local<Value> GetResourceName();
327
+ };
328
+
329
+ enum class ScriptType { kClassic, kModule };
330
+
331
+ /**
332
+ * For compiling scripts.
333
+ */
334
+ class V8_EXPORT ScriptCompiler {
335
+ public:
336
+ class ConsumeCodeCacheTask;
337
+
338
+ /**
339
+ * Compilation data that the embedder can cache and pass back to speed up
340
+ * future compilations. The data is produced if the CompilerOptions passed to
341
+ * the compilation functions in ScriptCompiler contains produce_data_to_cache
342
+ * = true. The data to cache can then can be retrieved from
343
+ * UnboundScript.
344
+ */
345
+ struct V8_EXPORT CachedData {
346
+ enum BufferPolicy { BufferNotOwned, BufferOwned };
347
+
348
+ CachedData()
349
+ : data(nullptr),
350
+ length(0),
351
+ rejected(false),
352
+ buffer_policy(BufferNotOwned) {}
353
+
354
+ // If buffer_policy is BufferNotOwned, the caller keeps the ownership of
355
+ // data and guarantees that it stays alive until the CachedData object is
356
+ // destroyed. If the policy is BufferOwned, the given data will be deleted
357
+ // (with delete[]) when the CachedData object is destroyed.
358
+ CachedData(const uint8_t* data, int length,
359
+ BufferPolicy buffer_policy = BufferNotOwned);
360
+ ~CachedData();
361
+ // TODO(marja): Async compilation; add constructors which take a callback
362
+ // which will be called when V8 no longer needs the data.
363
+ const uint8_t* data;
364
+ int length;
365
+ bool rejected;
366
+ BufferPolicy buffer_policy;
367
+
368
+ // Prevent copying.
369
+ CachedData(const CachedData&) = delete;
370
+ CachedData& operator=(const CachedData&) = delete;
371
+ };
372
+
373
+ /**
374
+ * Source code which can be then compiled to a UnboundScript or Script.
375
+ */
376
+ class Source {
377
+ public:
378
+ // Source takes ownership of both CachedData and CodeCacheConsumeTask.
379
+ // The caller *must* ensure that the cached data is from a trusted source.
380
+ V8_INLINE Source(Local<String> source_string, const ScriptOrigin& origin,
381
+ CachedData* cached_data = nullptr,
382
+ ConsumeCodeCacheTask* consume_cache_task = nullptr);
383
+ // Source takes ownership of both CachedData and CodeCacheConsumeTask.
384
+ V8_INLINE explicit Source(
385
+ Local<String> source_string, CachedData* cached_data = nullptr,
386
+ ConsumeCodeCacheTask* consume_cache_task = nullptr);
387
+ V8_INLINE ~Source() = default;
388
+
389
+ // Ownership of the CachedData or its buffers is *not* transferred to the
390
+ // caller. The CachedData object is alive as long as the Source object is
391
+ // alive.
392
+ V8_INLINE const CachedData* GetCachedData() const;
393
+
394
+ V8_INLINE const ScriptOriginOptions& GetResourceOptions() const;
395
+
396
+ private:
397
+ friend class ScriptCompiler;
398
+
399
+ Local<String> source_string;
400
+
401
+ // Origin information
402
+ Local<Value> resource_name;
403
+ int resource_line_offset;
404
+ int resource_column_offset;
405
+ ScriptOriginOptions resource_options;
406
+ Local<Value> source_map_url;
407
+ Local<Data> host_defined_options;
408
+
409
+ // Cached data from previous compilation (if a kConsume*Cache flag is
410
+ // set), or hold newly generated cache data (kProduce*Cache flags) are
411
+ // set when calling a compile method.
412
+ std::unique_ptr<CachedData> cached_data;
413
+ std::unique_ptr<ConsumeCodeCacheTask> consume_cache_task;
414
+ };
415
+
416
+ /**
417
+ * For streaming incomplete script data to V8. The embedder should implement a
418
+ * subclass of this class.
419
+ */
420
+ class V8_EXPORT ExternalSourceStream {
421
+ public:
422
+ virtual ~ExternalSourceStream() = default;
423
+
424
+ /**
425
+ * V8 calls this to request the next chunk of data from the embedder. This
426
+ * function will be called on a background thread, so it's OK to block and
427
+ * wait for the data, if the embedder doesn't have data yet. Returns the
428
+ * length of the data returned. When the data ends, GetMoreData should
429
+ * return 0. Caller takes ownership of the data.
430
+ *
431
+ * When streaming UTF-8 data, V8 handles multi-byte characters split between
432
+ * two data chunks, but doesn't handle multi-byte characters split between
433
+ * more than two data chunks. The embedder can avoid this problem by always
434
+ * returning at least 2 bytes of data.
435
+ *
436
+ * When streaming UTF-16 data, V8 does not handle characters split between
437
+ * two data chunks. The embedder has to make sure that chunks have an even
438
+ * length.
439
+ *
440
+ * If the embedder wants to cancel the streaming, they should make the next
441
+ * GetMoreData call return 0. V8 will interpret it as end of data (and most
442
+ * probably, parsing will fail). The streaming task will return as soon as
443
+ * V8 has parsed the data it received so far.
444
+ */
445
+ virtual size_t GetMoreData(const uint8_t** src) = 0;
446
+ };
447
+
448
+ /**
449
+ * Source code which can be streamed into V8 in pieces. It will be parsed
450
+ * while streaming and compiled after parsing has completed. StreamedSource
451
+ * must be kept alive while the streaming task is run (see ScriptStreamingTask
452
+ * below).
453
+ */
454
+ class V8_EXPORT StreamedSource {
455
+ public:
456
+ enum Encoding { ONE_BYTE, TWO_BYTE, UTF8, WINDOWS_1252 };
457
+
458
+ StreamedSource(std::unique_ptr<ExternalSourceStream> source_stream,
459
+ Encoding encoding);
460
+ ~StreamedSource();
461
+
462
+ internal::ScriptStreamingData* impl() const { return impl_.get(); }
463
+
464
+ // Prevent copying.
465
+ StreamedSource(const StreamedSource&) = delete;
466
+ StreamedSource& operator=(const StreamedSource&) = delete;
467
+
468
+ private:
469
+ std::unique_ptr<internal::ScriptStreamingData> impl_;
470
+ };
471
+
472
+ /**
473
+ * A streaming task which the embedder must run on a background thread to
474
+ * stream scripts into V8. Returned by ScriptCompiler::StartStreaming.
475
+ */
476
+ class V8_EXPORT ScriptStreamingTask final {
477
+ public:
478
+ void Run();
479
+
480
+ private:
481
+ friend class ScriptCompiler;
482
+
483
+ explicit ScriptStreamingTask(internal::ScriptStreamingData* data)
484
+ : data_(data) {}
485
+
486
+ internal::ScriptStreamingData* data_;
487
+ };
488
+
489
+ /**
490
+ * A task which the embedder must run on a background thread to
491
+ * consume a V8 code cache. Returned by
492
+ * ScriptCompiler::StarConsumingCodeCache.
493
+ */
494
+ class V8_EXPORT ConsumeCodeCacheTask final {
495
+ public:
496
+ ~ConsumeCodeCacheTask();
497
+
498
+ void Run();
499
+
500
+ private:
501
+ friend class ScriptCompiler;
502
+
503
+ explicit ConsumeCodeCacheTask(
504
+ std::unique_ptr<internal::BackgroundDeserializeTask> impl);
505
+
506
+ std::unique_ptr<internal::BackgroundDeserializeTask> impl_;
507
+ };
508
+
509
+ enum CompileOptions {
510
+ kNoCompileOptions = 0,
511
+ kConsumeCodeCache,
512
+ kEagerCompile
513
+ };
514
+
515
+ /**
516
+ * The reason for which we are not requesting or providing a code cache.
517
+ */
518
+ enum NoCacheReason {
519
+ kNoCacheNoReason = 0,
520
+ kNoCacheBecauseCachingDisabled,
521
+ kNoCacheBecauseNoResource,
522
+ kNoCacheBecauseInlineScript,
523
+ kNoCacheBecauseModule,
524
+ kNoCacheBecauseStreamingSource,
525
+ kNoCacheBecauseInspector,
526
+ kNoCacheBecauseScriptTooSmall,
527
+ kNoCacheBecauseCacheTooCold,
528
+ kNoCacheBecauseV8Extension,
529
+ kNoCacheBecauseExtensionModule,
530
+ kNoCacheBecausePacScript,
531
+ kNoCacheBecauseInDocumentWrite,
532
+ kNoCacheBecauseResourceWithNoCacheHandler,
533
+ kNoCacheBecauseDeferredProduceCodeCache
534
+ };
535
+
536
+ /**
537
+ * Compiles the specified script (context-independent).
538
+ * Cached data as part of the source object can be optionally produced to be
539
+ * consumed later to speed up compilation of identical source scripts.
540
+ *
541
+ * Note that when producing cached data, the source must point to NULL for
542
+ * cached data. When consuming cached data, the cached data must have been
543
+ * produced by the same version of V8, and the embedder needs to ensure the
544
+ * cached data is the correct one for the given script.
545
+ *
546
+ * \param source Script source code.
547
+ * \return Compiled script object (context independent; for running it must be
548
+ * bound to a context).
549
+ */
550
+ static V8_WARN_UNUSED_RESULT MaybeLocal<UnboundScript> CompileUnboundScript(
551
+ Isolate* isolate, Source* source,
552
+ CompileOptions options = kNoCompileOptions,
553
+ NoCacheReason no_cache_reason = kNoCacheNoReason);
554
+
555
+ /**
556
+ * Compiles the specified script (bound to current context).
557
+ *
558
+ * \param source Script source code.
559
+ * \param pre_data Pre-parsing data, as obtained by ScriptData::PreCompile()
560
+ * using pre_data speeds compilation if it's done multiple times.
561
+ * Owned by caller, no references are kept when this function returns.
562
+ * \return Compiled script object, bound to the context that was active
563
+ * when this function was called. When run it will always use this
564
+ * context.
565
+ */
566
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Script> Compile(
567
+ Local<Context> context, Source* source,
568
+ CompileOptions options = kNoCompileOptions,
569
+ NoCacheReason no_cache_reason = kNoCacheNoReason);
570
+
571
+ /**
572
+ * Returns a task which streams script data into V8, or NULL if the script
573
+ * cannot be streamed. The user is responsible for running the task on a
574
+ * background thread and deleting it. When ran, the task starts parsing the
575
+ * script, and it will request data from the StreamedSource as needed. When
576
+ * ScriptStreamingTask::Run exits, all data has been streamed and the script
577
+ * can be compiled (see Compile below).
578
+ *
579
+ * This API allows to start the streaming with as little data as possible, and
580
+ * the remaining data (for example, the ScriptOrigin) is passed to Compile.
581
+ */
582
+ static ScriptStreamingTask* StartStreaming(
583
+ Isolate* isolate, StreamedSource* source,
584
+ ScriptType type = ScriptType::kClassic);
585
+
586
+ static ConsumeCodeCacheTask* StartConsumingCodeCache(
587
+ Isolate* isolate, std::unique_ptr<CachedData> source);
588
+
589
+ /**
590
+ * Compiles a streamed script (bound to current context).
591
+ *
592
+ * This can only be called after the streaming has finished
593
+ * (ScriptStreamingTask has been run). V8 doesn't construct the source string
594
+ * during streaming, so the embedder needs to pass the full source here.
595
+ */
596
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Script> Compile(
597
+ Local<Context> context, StreamedSource* source,
598
+ Local<String> full_source_string, const ScriptOrigin& origin);
599
+
600
+ /**
601
+ * Return a version tag for CachedData for the current V8 version & flags.
602
+ *
603
+ * This value is meant only for determining whether a previously generated
604
+ * CachedData instance is still valid; the tag has no other meaing.
605
+ *
606
+ * Background: The data carried by CachedData may depend on the exact
607
+ * V8 version number or current compiler flags. This means that when
608
+ * persisting CachedData, the embedder must take care to not pass in
609
+ * data from another V8 version, or the same version with different
610
+ * features enabled.
611
+ *
612
+ * The easiest way to do so is to clear the embedder's cache on any
613
+ * such change.
614
+ *
615
+ * Alternatively, this tag can be stored alongside the cached data and
616
+ * compared when it is being used.
617
+ */
618
+ static uint32_t CachedDataVersionTag();
619
+
620
+ /**
621
+ * Compile an ES module, returning a Module that encapsulates
622
+ * the compiled code.
623
+ *
624
+ * Corresponds to the ParseModule abstract operation in the
625
+ * ECMAScript specification.
626
+ */
627
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Module> CompileModule(
628
+ Isolate* isolate, Source* source,
629
+ CompileOptions options = kNoCompileOptions,
630
+ NoCacheReason no_cache_reason = kNoCacheNoReason);
631
+
632
+ /**
633
+ * Compiles a streamed module script.
634
+ *
635
+ * This can only be called after the streaming has finished
636
+ * (ScriptStreamingTask has been run). V8 doesn't construct the source string
637
+ * during streaming, so the embedder needs to pass the full source here.
638
+ */
639
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Module> CompileModule(
640
+ Local<Context> context, StreamedSource* v8_source,
641
+ Local<String> full_source_string, const ScriptOrigin& origin);
642
+
643
+ /**
644
+ * Compile a function for a given context. This is equivalent to running
645
+ *
646
+ * with (obj) {
647
+ * return function(args) { ... }
648
+ * }
649
+ *
650
+ * It is possible to specify multiple context extensions (obj in the above
651
+ * example).
652
+ */
653
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Function> CompileFunctionInContext(
654
+ Local<Context> context, Source* source, size_t arguments_count,
655
+ Local<String> arguments[], size_t context_extension_count,
656
+ Local<Object> context_extensions[],
657
+ CompileOptions options = kNoCompileOptions,
658
+ NoCacheReason no_cache_reason = kNoCacheNoReason,
659
+ Local<ScriptOrModule>* script_or_module_out = nullptr);
660
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Function> CompileFunction(
661
+ Local<Context> context, Source* source, size_t arguments_count = 0,
662
+ Local<String> arguments[] = nullptr, size_t context_extension_count = 0,
663
+ Local<Object> context_extensions[] = nullptr,
664
+ CompileOptions options = kNoCompileOptions,
665
+ NoCacheReason no_cache_reason = kNoCacheNoReason);
666
+
667
+ /**
668
+ * Creates and returns code cache for the specified unbound_script.
669
+ * This will return nullptr if the script cannot be serialized. The
670
+ * CachedData returned by this function should be owned by the caller.
671
+ */
672
+ static CachedData* CreateCodeCache(Local<UnboundScript> unbound_script);
673
+
674
+ /**
675
+ * Creates and returns code cache for the specified unbound_module_script.
676
+ * This will return nullptr if the script cannot be serialized. The
677
+ * CachedData returned by this function should be owned by the caller.
678
+ */
679
+ static CachedData* CreateCodeCache(
680
+ Local<UnboundModuleScript> unbound_module_script);
681
+
682
+ /**
683
+ * Creates and returns code cache for the specified function that was
684
+ * previously produced by CompileFunction.
685
+ * This will return nullptr if the script cannot be serialized. The
686
+ * CachedData returned by this function should be owned by the caller.
687
+ */
688
+ static CachedData* CreateCodeCacheForFunction(Local<Function> function);
689
+
690
+ private:
691
+ static V8_WARN_UNUSED_RESULT MaybeLocal<UnboundScript> CompileUnboundInternal(
692
+ Isolate* isolate, Source* source, CompileOptions options,
693
+ NoCacheReason no_cache_reason);
694
+
695
+ static V8_WARN_UNUSED_RESULT MaybeLocal<Function> CompileFunctionInternal(
696
+ Local<Context> context, Source* source, size_t arguments_count,
697
+ Local<String> arguments[], size_t context_extension_count,
698
+ Local<Object> context_extensions[], CompileOptions options,
699
+ NoCacheReason no_cache_reason,
700
+ Local<ScriptOrModule>* script_or_module_out);
701
+ };
702
+
703
+ ScriptCompiler::Source::Source(Local<String> string, const ScriptOrigin& origin,
704
+ CachedData* data,
705
+ ConsumeCodeCacheTask* consume_cache_task)
706
+ : source_string(string),
707
+ resource_name(origin.ResourceName()),
708
+ resource_line_offset(origin.LineOffset()),
709
+ resource_column_offset(origin.ColumnOffset()),
710
+ resource_options(origin.Options()),
711
+ source_map_url(origin.SourceMapUrl()),
712
+ host_defined_options(origin.GetHostDefinedOptions()),
713
+ cached_data(data),
714
+ consume_cache_task(consume_cache_task) {}
715
+
716
+ ScriptCompiler::Source::Source(Local<String> string, CachedData* data,
717
+ ConsumeCodeCacheTask* consume_cache_task)
718
+ : source_string(string),
719
+ cached_data(data),
720
+ consume_cache_task(consume_cache_task) {}
721
+
722
+ const ScriptCompiler::CachedData* ScriptCompiler::Source::GetCachedData()
723
+ const {
724
+ return cached_data.get();
725
+ }
726
+
727
+ const ScriptOriginOptions& ScriptCompiler::Source::GetResourceOptions() const {
728
+ return resource_options;
729
+ }
730
+
731
+ ModuleRequest* ModuleRequest::Cast(Data* data) {
732
+ #ifdef V8_ENABLE_CHECKS
733
+ CheckCast(data);
734
+ #endif
735
+ return reinterpret_cast<ModuleRequest*>(data);
736
+ }
737
+
738
+ Module* Module::Cast(Data* data) {
739
+ #ifdef V8_ENABLE_CHECKS
740
+ CheckCast(data);
741
+ #endif
742
+ return reinterpret_cast<Module*>(data);
743
+ }
744
+
745
+ } // namespace v8
746
+
747
+ #endif // INCLUDE_V8_SCRIPT_H_