mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-11-04 07:10:57 +00:00
fb6de442c6
This patch adds the [[HostDefined]] field defined in https://tc39.es/ecma262/#table-module-record-fields to module records. Co-authored-by: davidot <davidot@serenityos.org>
112 lines
3.1 KiB
C++
112 lines
3.1 KiB
C++
/*
|
|
* Copyright (c) 2021, Andreas Kling <kling@serenityos.org>
|
|
* Copyright (c) 2022, David Tuin <davidot@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/FlyString.h>
|
|
#include <LibJS/Heap/GCPtr.h>
|
|
#include <LibJS/Runtime/Environment.h>
|
|
#include <LibJS/Runtime/Realm.h>
|
|
#include <LibJS/Script.h>
|
|
|
|
namespace JS {
|
|
|
|
struct ResolvedBinding {
|
|
enum Type {
|
|
BindingName,
|
|
Namespace,
|
|
Ambiguous,
|
|
Null,
|
|
};
|
|
|
|
static ResolvedBinding null()
|
|
{
|
|
return {};
|
|
}
|
|
|
|
static ResolvedBinding ambiguous()
|
|
{
|
|
ResolvedBinding binding;
|
|
binding.type = Ambiguous;
|
|
return binding;
|
|
}
|
|
|
|
Type type { Null };
|
|
Module* module { nullptr };
|
|
FlyString export_name;
|
|
|
|
bool is_valid() const
|
|
{
|
|
return type == BindingName || type == Namespace;
|
|
}
|
|
|
|
bool is_namespace() const
|
|
{
|
|
return type == Namespace;
|
|
}
|
|
|
|
bool is_ambiguous() const
|
|
{
|
|
return type == Ambiguous;
|
|
}
|
|
};
|
|
|
|
// 16.2.1.4 Abstract Module Records, https://tc39.es/ecma262/#sec-abstract-module-records
|
|
class Module : public Cell {
|
|
JS_CELL(Module, Cell);
|
|
|
|
public:
|
|
virtual ~Module() override;
|
|
|
|
Realm& realm() { return *m_realm; }
|
|
Realm const& realm() const { return *m_realm; }
|
|
|
|
StringView filename() const { return m_filename; }
|
|
|
|
Environment* environment() { return m_environment; }
|
|
|
|
Script::HostDefined* host_defined() const { return m_host_defined; }
|
|
|
|
ThrowCompletionOr<Object*> get_module_namespace(VM& vm);
|
|
|
|
virtual ThrowCompletionOr<void> link(VM& vm) = 0;
|
|
virtual ThrowCompletionOr<Promise*> evaluate(VM& vm) = 0;
|
|
|
|
virtual ThrowCompletionOr<Vector<FlyString>> get_exported_names(VM& vm, Vector<Module*> export_star_set = {}) = 0;
|
|
virtual ThrowCompletionOr<ResolvedBinding> resolve_export(VM& vm, FlyString const& export_name, Vector<ResolvedBinding> resolve_set = {}) = 0;
|
|
|
|
virtual ThrowCompletionOr<u32> inner_module_linking(VM& vm, Vector<Module*>& stack, u32 index);
|
|
virtual ThrowCompletionOr<u32> inner_module_evaluation(VM& vm, Vector<Module*>& stack, u32 index);
|
|
|
|
protected:
|
|
Module(Realm&, String filename, Script::HostDefined* host_defined = nullptr);
|
|
|
|
virtual void visit_edges(Cell::Visitor&) override;
|
|
|
|
void set_environment(Environment* environment)
|
|
{
|
|
m_environment = environment;
|
|
}
|
|
|
|
private:
|
|
Object* module_namespace_create(VM& vm, Vector<FlyString> unambiguous_names);
|
|
|
|
// These handles are only safe as long as the VM they live in is valid.
|
|
// But evaluated modules SHOULD be stored in the VM so unless you intentionally
|
|
// destroy the VM but keep the modules this should not happen. Because VM
|
|
// stores modules with a RefPtr we cannot just store the VM as that leads to
|
|
// cycles.
|
|
GCPtr<Realm> m_realm; // [[Realm]]
|
|
GCPtr<Environment> m_environment; // [[Environment]]
|
|
GCPtr<Object> m_namespace; // [[Namespace]]
|
|
Script::HostDefined* m_host_defined { nullptr }; // [[HostDefined]]
|
|
|
|
// Needed for potential lookups of modules.
|
|
String m_filename;
|
|
};
|
|
|
|
}
|