dymokomi/luce-browser-engine
Source of release 0.6.0
0.6.0 / src / web / css / url.lucb
#==============================================================================================
#
# url - URL and RequestURLModifier: <url> values and their request modifiers
#
# DESCRIPTION:
# Port of LibWeb/CSS/URL.cpp (lines 1-145) and the inline members of URL.h. The
# defaulted operator==s are css_url_eq and css_request_url_modifier_eq; the lambda that
# maps a referrer-policy modifier to a ReferrerPolicy is a function of its own.
#
# Copyright (c) 2025, Sam Atkins <sam@ladybird.org>
# SPDX-License-Identifier: BSD-2-Clause
#
#==============================================================================================
# mark: URL =====================================================================================
## Ported from Libraries/LibWeb/CSS/URL.cpp:14 Web::CSS::URL::URL.
pub func css_url_construct(this: CssUrl*, url: ak.String, type_: CssUrlType = CssUrlType.url, request_url_modifiers: ak.Vector[CssRequestUrlModifier]):
this.m_type = type_
this.m_url = url
this.m_request_url_modifiers = request_url_modifiers
## Ported from Libraries/LibWeb/CSS/URL.h:55 Web::CSS::URL::url.
pub func css_url_url(this: const CssUrl*) -> ak.String:
return this.m_url
## Ported from Libraries/LibWeb/CSS/URL.h:56 Web::CSS::URL::request_url_modifiers.
pub func css_url_request_url_modifiers(this: const CssUrl*) -> ak.Vector[CssRequestUrlModifier]:
return this.m_request_url_modifiers
## Ported from Libraries/LibWeb/CSS/URL.cpp:22 Web::CSS::URL::to_string.
# https://drafts.csswg.org/cssom-1/#serialize-a-url
pub func css_url_to_string(this: const CssUrl*) -> ak.String:
# To serialize a URL means to create a string represented by "url(", followed by the serialization of the URL as a
# string, followed by ")".
# AD-HOC: Serialize as src() if it was declared as that.
var builder = ak.string_builder_new()
match this.m_type:
.url: ak.string_builder_append(&builder, "url(")
.src: ak.string_builder_append(&builder, "src(")
_: trap("VERIFY_NOT_REACHED")
css_syntax.serialize_a_string_string_builder(&builder, ak.string_bytes_as_string_view(&this.m_url))
# AD-HOC: Serialize the RequestURLModifiers
# Spec issue: https://github.com/w3c/csswg-drafts/issues/12057
for modifier in ak.vector_span_const(&this.m_request_url_modifiers):
let modifier_string = css_request_url_modifier_to_string(&modifier)
ak.string_builder_append(&builder, " ")
ak.string_builder_append_string_view(&builder, ak.string_bytes_as_string_view(&modifier_string))
ak.string_builder_append_u8(&builder, ')')
return ak.string_builder_to_string_without_validation(&builder)
## Ported from Libraries/LibWeb/CSS/URL.cpp:48 Web::CSS::URL::operator== (defaulted).
pub func css_url_eq(this: const CssUrl*, arg0: CssUrl) -> bool:
if this.m_type != arg0.m_type:
return false
if not ak.string_equals(&this.m_url, &arg0.m_url):
return false
let size = ak.vector_size(&this.m_request_url_modifiers)
if size != ak.vector_size(&arg0.m_request_url_modifiers):
return false
for i in 0..<size:
let modifier = ak.vector_at_const(&this.m_request_url_modifiers, i)
if not css_request_url_modifier_eq(modifier, *ak.vector_at_const(&arg0.m_request_url_modifiers, i)):
return false
return true
# mark: RequestURLModifier ======================================================================
## Ported from Libraries/LibWeb/CSS/URL.cpp:50 Web::CSS::RequestURLModifier::create_cross_origin.
pub func css_request_url_modifier_create_cross_origin(value: css_data.CrossOriginModifierValue) -> CssRequestUrlModifier:
return css_request_url_modifier_new(CssRequestUrlModifierType.cross_origin, .cross_origin_modifier_value(value))
## Ported from Libraries/LibWeb/CSS/URL.cpp:55 Web::CSS::RequestURLModifier::create_integrity.
pub func css_request_url_modifier_create_integrity(value: ak.FlyString) -> CssRequestUrlModifier:
return css_request_url_modifier_new(CssRequestUrlModifierType.integrity, .fly_string(value))
## Ported from Libraries/LibWeb/CSS/URL.cpp:60 Web::CSS::RequestURLModifier::create_referrer_policy.
pub func css_request_url_modifier_create_referrer_policy(value: css_data.ReferrerPolicyModifierValue) -> CssRequestUrlModifier:
return css_request_url_modifier_new(CssRequestUrlModifierType.referrer_policy, .referrer_policy_modifier_value(value))
## Ported from Libraries/LibWeb/CSS/URL.cpp:65 Web::CSS::RequestURLModifier::RequestURLModifier.
pub func css_request_url_modifier_construct(this: CssRequestUrlModifier*, type_: CssRequestUrlModifierType, value: css_data.CssRequestUrlModifierValue):
this.m_type = type_
this.m_value = value
## `RequestURLModifier { type, value }` as a value.
func css_request_url_modifier_new(type_: CssRequestUrlModifierType, value: css_data.CssRequestUrlModifierValue) -> CssRequestUrlModifier:
var modifier: CssRequestUrlModifier = ---
css_request_url_modifier_construct(&modifier, type_, value)
return modifier
## Ported from Libraries/LibWeb/CSS/URL.cpp:71 Web::CSS::RequestURLModifier::modify_request.
pub func css_request_url_modifier_modify_request(this: const CssRequestUrlModifier*, request: FetchRequest*):
match this.m_type:
.cross_origin:
# https://drafts.csswg.org/css-values-5/#typedef-request-url-modifier-crossorigin-modifier
# The URL request modifier steps for this modifier given request req are:
# 1. Set req’s mode to "cors".
fetch_request_set_mode(request, FetchRequestMode.cors)
# 2. If the given value is use-credentials, set req’s credentials mode to "include".
if css_request_url_modifier_value_is(this, css_data.CrossOriginModifierValue.use_credentials):
fetch_request_set_credentials_mode(request, FetchRequestCredentialsMode.include)
# 3. Otherwise, set req’s credentials mode to "same-origin".
else:
fetch_request_set_credentials_mode(request, FetchRequestCredentialsMode.same_origin)
.integrity:
# https://drafts.csswg.org/css-values-5/#typedef-request-url-modifier-integrity-modifier
# The URL request modifier steps for this modifier given request req are to set request’s integrity metadata to
# the given <string>.
match this.m_value:
.fly_string(value): fetch_request_set_integrity_metadata(request, ak.fly_string_to_string_const(&value))
_: trap("VERIFY: a FlyString")
.referrer_policy:
# https://drafts.csswg.org/css-values-5/#typedef-request-url-modifier-referrerpolicy-modifier
# The URL request modifier steps for this modifier given request req are to set request’s referrer policy to the
# ReferrerPolicy that matches the given value.
match this.m_value:
.referrer_policy_modifier_value(value): fetch_request_set_referrer_policy(request, css_request_url_modifier_referrer_policy(value))
_: trap("VERIFY: a ReferrerPolicyModifierValue")
_: trap("VERIFY_NOT_REACHED")
## `m_value == value` for a CrossOriginModifierValue (Variant::operator== with an alternative).
func css_request_url_modifier_value_is(this: const CssRequestUrlModifier*, value: css_data.CrossOriginModifierValue) -> bool:
match this.m_value:
.cross_origin_modifier_value(held): return held == value
_: return false
## modify_request's lambda: the ReferrerPolicy of a referrer-policy() modifier value.
func css_request_url_modifier_referrer_policy(value: css_data.ReferrerPolicyModifierValue) -> ReferrerPolicyReferrerPolicy:
match value:
.no_referrer: return ReferrerPolicyReferrerPolicy.no_referrer
.no_referrer_when_downgrade: return ReferrerPolicyReferrerPolicy.no_referrer_when_downgrade
.same_origin: return ReferrerPolicyReferrerPolicy.same_origin
.origin: return ReferrerPolicyReferrerPolicy.origin
.strict_origin: return ReferrerPolicyReferrerPolicy.strict_origin
.origin_when_cross_origin: return ReferrerPolicyReferrerPolicy.origin_when_cross_origin
.strict_origin_when_cross_origin: return ReferrerPolicyReferrerPolicy.strict_origin_when_cross_origin
.unsafe_url: return ReferrerPolicyReferrerPolicy.unsafe_url
_: trap("VERIFY_NOT_REACHED")
## Ported from Libraries/LibWeb/CSS/URL.h:33 Web::CSS::RequestURLModifier::type.
pub func css_request_url_modifier_type(this: const CssRequestUrlModifier*) -> CssRequestUrlModifierType:
return this.m_type
## Ported from Libraries/LibWeb/CSS/URL.cpp:130 Web::CSS::RequestURLModifier::to_string.
pub func css_request_url_modifier_to_string(this: const CssRequestUrlModifier*) -> ak.String:
var builder = ak.string_builder_new()
match this.m_value:
.cross_origin_modifier_value(value):
assert(this.m_type == CssRequestUrlModifierType.cross_origin)
ak.string_builder_append(&builder, "cross-origin(")
ak.string_builder_append_string_view(&builder, css_data.to_string_cross_origin_modifier_value(value))
.fly_string(value):
assert(this.m_type == CssRequestUrlModifierType.integrity)
let serialized = css_syntax.serialize_a_string_string_view(ak.fly_string_bytes_as_string_view(&value))
ak.string_builder_append(&builder, "integrity(")
ak.string_builder_append_string_view(&builder, ak.string_bytes_as_string_view(&serialized))
.referrer_policy_modifier_value(value):
assert(this.m_type == CssRequestUrlModifierType.referrer_policy)
ak.string_builder_append(&builder, "referrer-policy(")
ak.string_builder_append_string_view(&builder, css_data.to_string_referrer_policy_modifier_value(value))
ak.string_builder_append(&builder, ")")
return ak.string_builder_to_string(&builder) else trap("MUST: String::formatted")
## Ported from Libraries/LibWeb/CSS/URL.cpp:143 Web::CSS::RequestURLModifier::operator== (defaulted).
pub func css_request_url_modifier_eq(this: const CssRequestUrlModifier*, arg0: CssRequestUrlModifier) -> bool:
if this.m_type != arg0.m_type:
return false
match this.m_value:
.cross_origin_modifier_value(value):
match arg0.m_value:
.cross_origin_modifier_value(other): return value == other
_: return false
.referrer_policy_modifier_value(value):
match arg0.m_value:
.referrer_policy_modifier_value(other): return value == other
_: return false
.fly_string(value):
match arg0.m_value:
.fly_string(other): return ak.fly_string_eq_fly_string(&value, &other)
_: return false