2020-03-07 19:42:11 +01:00
|
|
|
/*
|
|
|
|
* Copyright (c) 2020, Andreas Kling <kling@serenityos.org>
|
2021-05-13 23:58:45 +01:00
|
|
|
* Copyright (c) 2020-2021, Linus Groh <linusg@serenityos.org>
|
2020-03-07 19:42:11 +01:00
|
|
|
*
|
2021-04-22 01:24:48 -07:00
|
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
2020-03-07 19:42:11 +01:00
|
|
|
*/
|
|
|
|
|
2021-05-13 23:58:45 +01:00
|
|
|
#include <AK/ScopeGuard.h>
|
2020-03-07 19:42:11 +01:00
|
|
|
#include <LibJS/AST.h>
|
|
|
|
#include <LibJS/Interpreter.h>
|
2021-09-22 12:44:56 +02:00
|
|
|
#include <LibJS/Runtime/AbstractOperations.h>
|
2021-09-24 22:40:38 +02:00
|
|
|
#include <LibJS/Runtime/ECMAScriptFunctionObject.h>
|
2021-07-01 12:24:46 +02:00
|
|
|
#include <LibJS/Runtime/FunctionEnvironment.h>
|
|
|
|
#include <LibJS/Runtime/GlobalEnvironment.h>
|
2020-03-16 14:20:30 +01:00
|
|
|
#include <LibJS/Runtime/GlobalObject.h>
|
2020-04-27 12:37:27 +02:00
|
|
|
#include <LibJS/Runtime/Reference.h>
|
2020-04-02 19:32:21 +02:00
|
|
|
#include <LibJS/Runtime/Shape.h>
|
2020-03-16 14:20:30 +01:00
|
|
|
#include <LibJS/Runtime/Value.h>
|
2020-03-07 19:42:11 +01:00
|
|
|
|
|
|
|
namespace JS {
|
|
|
|
|
2021-09-12 12:33:54 +01:00
|
|
|
NonnullOwnPtr<Interpreter> Interpreter::create_with_existing_realm(Realm& realm)
|
2020-09-27 17:24:14 +02:00
|
|
|
{
|
2021-09-12 12:33:54 +01:00
|
|
|
auto& global_object = realm.global_object();
|
2020-09-27 17:24:14 +02:00
|
|
|
DeferGC defer_gc(global_object.heap());
|
|
|
|
auto interpreter = adopt_own(*new Interpreter(global_object.vm()));
|
2021-09-11 19:36:25 +01:00
|
|
|
interpreter->m_global_object = make_handle(&global_object);
|
2021-09-12 12:33:54 +01:00
|
|
|
interpreter->m_realm = make_handle(&realm);
|
2020-09-27 17:24:14 +02:00
|
|
|
return interpreter;
|
|
|
|
}
|
|
|
|
|
2020-09-20 19:24:44 +02:00
|
|
|
Interpreter::Interpreter(VM& vm)
|
|
|
|
: m_vm(vm)
|
2020-03-07 19:42:11 +01:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
Interpreter::~Interpreter()
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2022-01-08 21:28:27 +01:00
|
|
|
ThrowCompletionOr<Value> Interpreter::run(GlobalObject& global_object, const Program& program)
|
2020-03-07 19:42:11 +01:00
|
|
|
{
|
2021-09-11 20:27:36 +01:00
|
|
|
// FIXME: Why does this receive a GlobalObject? Interpreter has one already, and this might not be in sync with the Realm's GlobalObject.
|
|
|
|
|
2020-11-08 12:54:52 +00:00
|
|
|
auto& vm = this->vm();
|
2021-02-23 20:42:32 +01:00
|
|
|
VERIFY(!vm.exception());
|
2020-04-13 16:42:54 +02:00
|
|
|
|
2020-09-27 15:18:55 +02:00
|
|
|
VM::InterpreterExecutionScope scope(*this);
|
2020-03-09 21:13:55 +01:00
|
|
|
|
2021-08-09 17:09:48 -04:00
|
|
|
ExecutionContext execution_context(heap());
|
2021-06-24 19:17:45 +02:00
|
|
|
execution_context.current_node = &program;
|
|
|
|
execution_context.this_value = &global_object;
|
2020-10-13 23:49:19 +02:00
|
|
|
static FlyString global_execution_context_name = "(global execution context)";
|
2021-06-24 19:17:45 +02:00
|
|
|
execution_context.function_name = global_execution_context_name;
|
2021-09-11 20:27:36 +01:00
|
|
|
execution_context.lexical_environment = &realm().global_environment();
|
|
|
|
execution_context.variable_environment = &realm().global_environment();
|
2021-09-11 21:42:01 +01:00
|
|
|
execution_context.realm = &realm();
|
2021-06-24 19:17:45 +02:00
|
|
|
execution_context.is_strict_mode = program.is_strict_mode();
|
2021-11-14 12:20:49 +00:00
|
|
|
MUST(vm.push_execution_context(execution_context, global_object));
|
2022-01-02 21:37:50 +01:00
|
|
|
auto completion = program.execute(*this, global_object);
|
2021-04-24 18:21:02 +02:00
|
|
|
|
|
|
|
// At this point we may have already run any queued promise jobs via on_call_stack_emptied,
|
|
|
|
// in which case this is a no-op.
|
LibJS: Add initial support for Promises
Almost a year after first working on this, it's finally done: an
implementation of Promises for LibJS! :^)
The core functionality is working and closely following the spec [1].
I mostly took the pseudo code and transformed it into C++ - if you read
and understand it, you will know how the spec implements Promises; and
if you read the spec first, the code will look very familiar.
Implemented functions are:
- Promise() constructor
- Promise.prototype.then()
- Promise.prototype.catch()
- Promise.prototype.finally()
- Promise.resolve()
- Promise.reject()
For the tests I added a new function to test-js's global object,
runQueuedPromiseJobs(), which calls vm.run_queued_promise_jobs().
By design, queued jobs normally only run after the script was fully
executed, making it improssible to test handlers in individual test()
calls by default [2].
Subsequent commits include integrations into LibWeb and js(1) -
pretty-printing, running queued promise jobs when necessary.
This has an unusual amount of dbgln() statements, all hidden behind the
PROMISE_DEBUG flag - I'm leaving them in for now as they've been very
useful while debugging this, things can get quite complex with so many
asynchronously executed functions.
I've not extensively explored use of these APIs for promise-based
functionality in LibWeb (fetch(), Notification.requestPermission()
etc.), but we'll get there in due time.
[1]: https://tc39.es/ecma262/#sec-promise-objects
[2]: https://tc39.es/ecma262/#sec-jobs-and-job-queues
2021-04-01 22:13:29 +02:00
|
|
|
vm.run_queued_promise_jobs();
|
2021-06-12 17:32:54 +03:00
|
|
|
|
2021-06-15 22:16:17 +03:00
|
|
|
vm.run_queued_finalization_registry_cleanup_jobs();
|
|
|
|
|
2021-10-08 23:22:50 +01:00
|
|
|
vm.pop_execution_context();
|
|
|
|
|
2021-06-12 17:32:54 +03:00
|
|
|
vm.finish_execution_generation();
|
2022-01-08 21:28:27 +01:00
|
|
|
|
|
|
|
if (completion.is_abrupt()) {
|
|
|
|
VERIFY(completion.type() == Completion::Type::Throw);
|
|
|
|
return completion.release_error();
|
|
|
|
}
|
|
|
|
return completion.value().value_or(js_undefined());
|
2020-03-09 21:13:55 +01:00
|
|
|
}
|
|
|
|
|
2020-09-27 15:18:55 +02:00
|
|
|
GlobalObject& Interpreter::global_object()
|
2020-04-27 12:37:27 +02:00
|
|
|
{
|
2020-09-27 15:18:55 +02:00
|
|
|
return static_cast<GlobalObject&>(*m_global_object.cell());
|
2020-04-27 12:37:27 +02:00
|
|
|
}
|
|
|
|
|
2020-09-27 15:18:55 +02:00
|
|
|
const GlobalObject& Interpreter::global_object() const
|
2020-03-09 21:29:22 +01:00
|
|
|
{
|
2020-09-27 15:18:55 +02:00
|
|
|
return static_cast<const GlobalObject&>(*m_global_object.cell());
|
2020-03-09 21:29:22 +01:00
|
|
|
}
|
|
|
|
|
2021-09-11 19:36:25 +01:00
|
|
|
Realm& Interpreter::realm()
|
|
|
|
{
|
|
|
|
return static_cast<Realm&>(*m_realm.cell());
|
|
|
|
}
|
|
|
|
|
|
|
|
const Realm& Interpreter::realm() const
|
|
|
|
{
|
|
|
|
return static_cast<const Realm&>(*m_realm.cell());
|
|
|
|
}
|
|
|
|
|
2020-03-07 19:42:11 +01:00
|
|
|
}
|