URL schemes: Difference between revisions

Revision as of 17:21, 28 November 2012

Licensing: this page is under CC0, not the MIT License.

about: URLs serve as identifier, potentially with an associated resource. The identifier is given in the URL's scheme data.

Identifier	Resource	Notes
"blank"	A resource whose Content-Type is text/html;charset=utf-8 and entity body is the empty string.
"invalid"	-	Used to represent a network error. See also CSS Values and Units.
"legacy-compat"	-	Used in HTML for XSLT serializers.
"srcdoc"	-	Used in HTML for its <iframe srcdoc> feature.
"unicorn"	A resource whose Content-Type is image/svg+xml and entity body is the contents of unicorn.svg.	Unicorn!

To obtain a resource from an about: URL, run these steps:

If URL's scheme data is not the literal string "blank" or "unicorn", return a network error. (URL's query and URL's fragment are simply not taken into account and can be anything.)
Return the resource corresponding to the identifier as listed in the table above, with HTTP status code 200 and HTTP status text "OK".

See also The "about" URI Scheme and "about" URI Tokens which this wiki page obsoletes.

Input	Result
about:blanK	network error (uppercase K)
about:bl%61nk	network error (no percent decoding by either the URL parser or the obtain a resource algorithm)
about:blank?teehee	works (query does not matter)
about:blank?teehee#hihi	works (fragment does not matter either)

javascript: URLs represent a JavaScript script.

To obtain a script from a javascript: URL, run these steps:

Let input be the concatenation of URL's scheme data, followed by "?" and URL's query if URL's query is non-null, followed by "#" and URL's fragment if URL's fragment is non-null.
Set input to the result of percent decoding input.
If input starts with a U+FEFF, remove a single occurrence from the start of input.
Return input.

@@ Line 34: / Line 34: @@
 To '''obtain a resource''' from an about: URL, run these steps:
-* If URL's scheme data is not the literal string "about" or "invalid", return a network error. (URL's query and URL's fragment are simply not taken into account and can be anything.)
+* If URL's scheme data is not the literal string "blank" or "unicorn", return a network error. (URL's query and URL's fragment are simply not taken into account and can be anything.)
 * Return the resource corresponding to the identifier as listed in the table above, with HTTP status code 200 and HTTP status text "OK".