// Copyright 2013 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. // Functions for canonicalizing "path" URLs. Not to be confused with the path // of a URL, these are URLs that have no authority section, only a path. For // example, "javascript:" and "data:". #include "url/url_canon.h" #include "url/url_canon_internal.h" namespace url { namespace { // Canonicalize the given |component| from |source| into |output| and // |new_component|. If |separator| is non-zero, it is pre-pended to |output| // prior to the canonicalized component; i.e. for the '?' or '#' characters. template void DoCanonicalizePathComponent(const CHAR* source, const Component& component, char separator, CanonOutput* output, Component* new_component) { if (component.is_valid()) { if (separator) output->push_back(separator); // Copy the path using path URL's more lax escaping rules (think for // javascript:). We convert to UTF-8 and escape characters from the // C0 control percent-encode set, but leave all other characters alone. // This helps readability of JavaScript. // https://url.spec.whatwg.org/#cannot-be-a-base-url-path-state // https://url.spec.whatwg.org/#c0-control-percent-encode-set new_component->begin = output->length(); int end = component.end(); for (int i = component.begin; i < end; i++) { UCHAR uch = static_cast(source[i]); if (uch < 0x20 || uch > 0x7E) AppendUTF8EscapedChar(source, &i, end, output); else output->push_back(static_cast(uch)); } new_component->len = output->length() - new_component->begin; } else { // Empty part. new_component->reset(); } } template bool DoCanonicalizePathURL(const URLComponentSource& source, const Parsed& parsed, CanonOutput* output, Parsed* new_parsed) { // Scheme: this will append the colon. bool success = CanonicalizeScheme(source.scheme, parsed.scheme, output, &new_parsed->scheme); // We assume there's no authority for path URLs. Note that hosts should never // have -1 length. new_parsed->username.reset(); new_parsed->password.reset(); new_parsed->host.reset(); new_parsed->port.reset(); // Canonicalize path via the weaker path URL rules. // // Note: parsing the path part should never cause a failure, see // https://url.spec.whatwg.org/#cannot-be-a-base-url-path-state DoCanonicalizePathComponent(source.path, parsed.path, '\0', output, &new_parsed->path); // Similar to mailto:, always use the default UTF-8 charset converter for // query. CanonicalizeQuery(source.query, parsed.query, nullptr, output, &new_parsed->query); CanonicalizeRef(source.ref, parsed.ref, output, &new_parsed->ref); return success; } } // namespace bool CanonicalizePathURL(const char* spec, int spec_len, const Parsed& parsed, CanonOutput* output, Parsed* new_parsed) { return DoCanonicalizePathURL( URLComponentSource(spec), parsed, output, new_parsed); } bool CanonicalizePathURL(const char16_t* spec, int spec_len, const Parsed& parsed, CanonOutput* output, Parsed* new_parsed) { return DoCanonicalizePathURL( URLComponentSource(spec), parsed, output, new_parsed); } void CanonicalizePathURLPath(const char* source, const Component& component, CanonOutput* output, Component* new_component) { DoCanonicalizePathComponent(source, component, '\0', output, new_component); } void CanonicalizePathURLPath(const char16_t* source, const Component& component, CanonOutput* output, Component* new_component) { DoCanonicalizePathComponent(source, component, '\0', output, new_component); } bool ReplacePathURL(const char* base, const Parsed& base_parsed, const Replacements& replacements, CanonOutput* output, Parsed* new_parsed) { URLComponentSource source(base); Parsed parsed(base_parsed); SetupOverrideComponents(base, replacements, &source, &parsed); return DoCanonicalizePathURL( source, parsed, output, new_parsed); } bool ReplacePathURL(const char* base, const Parsed& base_parsed, const Replacements& replacements, CanonOutput* output, Parsed* new_parsed) { RawCanonOutput<1024> utf8; URLComponentSource source(base); Parsed parsed(base_parsed); SetupUTF16OverrideComponents(base, replacements, &utf8, &source, &parsed); return DoCanonicalizePathURL( source, parsed, output, new_parsed); } } // namespace url