
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
123 lines
4 KiB
C++
123 lines
4 KiB
C++
/*
|
|
* Copyright (c) 2020, Andreas Kling <kling@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#include <AK/StringBuilder.h>
|
|
#include <AK/Utf32View.h>
|
|
#include <LibJS/Runtime/Array.h>
|
|
#include <LibJS/Runtime/Error.h>
|
|
#include <LibJS/Runtime/GlobalObject.h>
|
|
#include <LibJS/Runtime/StringConstructor.h>
|
|
#include <LibJS/Runtime/StringObject.h>
|
|
|
|
namespace JS {
|
|
|
|
StringConstructor::StringConstructor(GlobalObject& global_object)
|
|
: NativeFunction(vm().names.String, *global_object.function_prototype())
|
|
{
|
|
}
|
|
|
|
void StringConstructor::initialize(GlobalObject& global_object)
|
|
{
|
|
auto& vm = this->vm();
|
|
NativeFunction::initialize(global_object);
|
|
|
|
// 22.1.2.3 String.prototype, https://tc39.es/ecma262/#sec-string.prototype
|
|
define_property(vm.names.prototype, global_object.string_prototype(), 0);
|
|
|
|
define_property(vm.names.length, Value(1), Attribute::Configurable);
|
|
|
|
u8 attr = Attribute::Writable | Attribute::Configurable;
|
|
define_native_function(vm.names.raw, raw, 1, attr);
|
|
define_native_function(vm.names.fromCharCode, from_char_code, 1, attr);
|
|
}
|
|
|
|
StringConstructor::~StringConstructor()
|
|
{
|
|
}
|
|
|
|
// 22.1.1.1 String ( value ), https://tc39.es/ecma262/#sec-string-constructor-string-value
|
|
Value StringConstructor::call()
|
|
{
|
|
if (!vm().argument_count())
|
|
return js_string(heap(), "");
|
|
if (vm().argument(0).is_symbol())
|
|
return js_string(heap(), vm().argument(0).as_symbol().to_string());
|
|
auto* string = vm().argument(0).to_primitive_string(global_object());
|
|
if (vm().exception())
|
|
return {};
|
|
return string;
|
|
}
|
|
|
|
// 22.1.1.1 String ( value ), https://tc39.es/ecma262/#sec-string-constructor-string-value
|
|
Value StringConstructor::construct(Function&)
|
|
{
|
|
PrimitiveString* primitive_string = nullptr;
|
|
if (!vm().argument_count())
|
|
primitive_string = js_string(vm(), "");
|
|
else
|
|
primitive_string = vm().argument(0).to_primitive_string(global_object());
|
|
if (!primitive_string)
|
|
return {};
|
|
return StringObject::create(global_object(), *primitive_string);
|
|
}
|
|
|
|
// 22.1.2.4 String.raw ( template, ...substitutions ), https://tc39.es/ecma262/#sec-string.raw
|
|
JS_DEFINE_NATIVE_FUNCTION(StringConstructor::raw)
|
|
{
|
|
auto* template_object = vm.argument(0).to_object(global_object);
|
|
if (vm.exception())
|
|
return {};
|
|
|
|
auto raw = template_object->get(vm.names.raw);
|
|
if (vm.exception())
|
|
return {};
|
|
if (raw.is_empty() || raw.is_nullish()) {
|
|
vm.throw_exception<TypeError>(global_object, ErrorType::StringRawCannotConvert, raw.is_null() ? "null" : "undefined");
|
|
return {};
|
|
}
|
|
// FIXME: This should use length_of_array_like() and work with any object
|
|
if (!raw.is_object() || !raw.as_object().is_array())
|
|
return js_string(vm, "");
|
|
|
|
auto* array = static_cast<Array*>(raw.to_object(global_object));
|
|
auto& raw_array_elements = array->indexed_properties();
|
|
StringBuilder builder;
|
|
|
|
for (size_t i = 0; i < raw_array_elements.array_like_size(); ++i) {
|
|
auto result = raw_array_elements.get(array, i);
|
|
if (vm.exception())
|
|
return {};
|
|
if (!result.has_value())
|
|
continue;
|
|
builder.append(result.value().value.to_string(global_object));
|
|
if (vm.exception())
|
|
return {};
|
|
if (i + 1 < vm.argument_count() && i < raw_array_elements.array_like_size() - 1) {
|
|
builder.append(vm.argument(i + 1).to_string(global_object));
|
|
if (vm.exception())
|
|
return {};
|
|
}
|
|
}
|
|
|
|
return js_string(vm, builder.build());
|
|
}
|
|
|
|
// 22.1.2.1 String.fromCharCode ( ...codeUnits ), https://tc39.es/ecma262/#sec-string.fromcharcode
|
|
JS_DEFINE_NATIVE_FUNCTION(StringConstructor::from_char_code)
|
|
{
|
|
StringBuilder builder;
|
|
for (size_t i = 0; i < vm.argument_count(); ++i) {
|
|
auto char_code = vm.argument(i).to_i32(global_object);
|
|
if (vm.exception())
|
|
return {};
|
|
auto truncated = char_code & 0xffff;
|
|
// FIXME: We need an Utf16View :^)
|
|
builder.append(Utf32View((u32*)&truncated, 1));
|
|
}
|
|
return js_string(vm, builder.build());
|
|
}
|
|
|
|
}
|