7327a28ccc
As mentioned on Discord earlier, we'll add these to all new functions going forward - this is the backfill. Reasons: - It makes you look at the spec, implementing based on MDN or V8 behavior is a no-go - It makes finding the various functions that are non-compliant easier, in the future everything should either have such a comment or, if it's not from the spec at all, a comment explaining why that is the case - It makes it easier to check whether a certain abstract operation is implemented in LibJS, not all of them use the same name as the spec. E.g. RejectPromise() is Promise::reject() - It makes it easier to reason about vm.arguments(), e.g. when the function has a rest parameter - It makes it easier to see whether a certain function is from a proposal or Annex B Also: - Add arguments to all functions and abstract operations that already had a comment - Fix some outdated section numbers - Replace some ecma-international.org URLs with tc39.es
54 lines
1.6 KiB
C++
54 lines
1.6 KiB
C++
/*
|
|
* Copyright (c) 2021, Linus Groh <linusg@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <LibJS/Runtime/GlobalObject.h>
|
|
#include <LibJS/Runtime/JobCallback.h>
|
|
#include <LibJS/Runtime/VM.h>
|
|
|
|
namespace JS {
|
|
|
|
// 27.2.1.1 PromiseCapability Records, https://tc39.es/ecma262/#sec-promisecapability-records
|
|
struct PromiseCapability {
|
|
Object* promise;
|
|
Function* resolve;
|
|
Function* reject;
|
|
};
|
|
|
|
// 27.2.1.5 NewPromiseCapability ( C ), https://tc39.es/ecma262/#sec-newpromisecapability
|
|
PromiseCapability new_promise_capability(GlobalObject& global_object, Value constructor);
|
|
|
|
// 27.2.1.2 PromiseReaction Records, https://tc39.es/ecma262/#sec-promisereaction-records
|
|
class PromiseReaction final : public Cell {
|
|
public:
|
|
enum class Type {
|
|
Fulfill,
|
|
Reject,
|
|
};
|
|
|
|
static PromiseReaction* create(VM& vm, Type type, Optional<PromiseCapability> capability, Optional<JobCallback> handler)
|
|
{
|
|
return vm.heap().allocate_without_global_object<PromiseReaction>(type, capability, handler);
|
|
}
|
|
|
|
PromiseReaction(Type type, Optional<PromiseCapability> capability, Optional<JobCallback> handler);
|
|
virtual ~PromiseReaction() = default;
|
|
|
|
Type type() const { return m_type; }
|
|
const Optional<PromiseCapability>& capability() const { return m_capability; }
|
|
const Optional<JobCallback>& handler() const { return m_handler; }
|
|
|
|
private:
|
|
virtual const char* class_name() const override { return "PromiseReaction"; }
|
|
virtual void visit_edges(Visitor&) override;
|
|
|
|
Type m_type;
|
|
Optional<PromiseCapability> m_capability;
|
|
Optional<JobCallback> m_handler;
|
|
};
|
|
|
|
}
|