Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
305 lines (198 sloc) 8.92 KB
data/url-schemes.json
~~~~~~~~~~~~~~~~~~~~~
This file contains known URL schemes and their properties.
Data file:
<https://raw.githubusercontent.com/manakai/data-web-defs/master/data/url-schemes.json>
Documentation (this file):
<https://github.com/manakai/data-web-defs/blob/master/doc/url-schemes.txt>
* Structure
The JSON file contains an object, whose members are URL schemes (not
including the trailing ":" character). Their corresponding values are
properties for the URL scheme.
* Properties
additional-default-port [number?]
Default port not included in the URL Standard's |default-port|
table.
application [object?]
If specified, the URL scheme is heavily coupled with specific
application programs. The object can contain following name/value
pairs:
android [boolean]
The URL scheme is mainly used for an Android application.
ios [boolean]
The URL scheme is mainly used for an iOS application.
mac [boolean]
The URL scheme is mainly used for a Mac OS X application.
archive [boolean]
Archive and/or compression format.
authority [string]
Semantics of the |authority| component, if known, other than
|x-callback-url|. One of following values:
any Any value can be used.
empty Always empty.
fake Something other than |host|, |user|, or ID.
host Host and optional port, optionally with user.
host+ Same as |host| but other options are also available.
id Some kind of local object ID, including package names.
network Some kind of network object ID.
none Never used.
recursive URL or an encoded URL.
resourceless_jid resource-less JID.
reverse-domain Reverse domain name.
user Some kind of user ID.
bad_ports [object?]
List of bad ports (i.e. targets of port blocking) for the scheme
<https://fetch.spec.whatwg.org/#block-bad-port>. If no value is
specified, any port is *allowed*. Otherwise, the names of the value
are *blocked* ports for the scheme, in shortest decimal form, and
the values of the value are [boolean] true values.
browser [boolean]
Used by Web browsers for Web platform, internal use, or browser
extensions.
conflict [boolean]
There are multiple independent definitions or usages, sometimes
incompatible.
contact [boolean]
Contact address such as email address or tel number.
default-port [number?]
The default port <https://url.spec.whatwg.org/#default-port> of the
scheme, if defined. See also |scheme-default-port|.
fetch [boolean]
Whether the scheme is a fetch scheme
<https://url.spec.whatwg.org/#fetch-scheme> or not.
fragment [string?]
If |MUST NOT|, the fragment identifier is not allowed for the URL
scheme. Otherwise, if |data|, the fragment component is considered
as part of the scheme data.
http [boolean]
Whether the URL scheme is an HTTP(S) scheme
<https://url.spec.whatwg.org/#http-scheme> or not.
http-variant [boolean]
Whether the URL scheme is a variant of the |http:| URL scheme for a
specific application.
https-variant [boolean]
Whether the URL scheme is a variant of the |https:| URL scheme for a
specific application.
iana [string?]
Status in the IANA registry
<https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml>, if
the URL scheme is contained in the IANA registry.
permanent - Permanent URI Schemes.
provisional - Provisional URI Schemes.
historical - Historical URI Schemes.
ill-formed [boolean]
Syntactically broken as URL scheme name.
is-local [boolean]
Whether the scheme is a local scheme
<https://url.spec.whatwg.org/#local-scheme> or not. Note that this
is different from "local".
itunes_ids [object?]
Known iTunes ID for the iOS application that supports the URL
scheme. Names are IDs as [integer] and values are [boolean] true
values.
local [boolean]
Resource in user's local environment. Note that this is different
from "is-local".
network [boolean]
Whether the scheme is a network scheme
<https://url.spec.whatwg.org/#network-scheme> or not.
no-tls [string?]
Name of a variant URL scheme (without ":" suffix) which shares the
same underlying protocol but without SSL/TLS or DTLS.
nsurl [boolean]
Whether URLs using the URL scheme are frequently used as names
rather than locators such as namespace URLs and feature identifiers
or not.
obsolete [boolean]
Whether the URL scheme (the scheme and/or the protocol associated
with the scheme) is obsolete or not.
origin [string?]
How to determine the origin
<https://url.spec.whatwg.org/#concept-url-origin> of a URL whose
scheme is this scheme. If specified, one of following values:
|file| The origin of the URL is determined by an
implementation-dependent rule.
|hostport| The origin of the URL is a tuple of (scheme, host, port).
|nested| The origin of the URL is the origin of the scheme data
parsed as a URL.
If not specified, the origin of the URL is an opaque origin.
protocol [boolean]
Resource retrevable by the protocol of the scheme.
query [string?]
Interpretation of query component, if known, using one of following
values:
|any| Any value. Interpreted by the author (e.g. server).
|comma-separated| Comma-separated values.
|data| Considered as part of the scheme data.
|none| Not used.
|nv| Zero or more name, |=|, and value separated by |&|.
|semicolon-nv| Zero or more name, |=|, and value separated by |;|.
registerable [boolean]
Whitelisted schemes <http://c.whatwg.org/#whitelisted-scheme>.
relative [boolean]
Relative scheme <https://url.spec.whatwg.org/#relative-scheme>.
scheme-default-port [string?]
The default port of the scheme. The value is a [number] if the
default defined by the (explicit or implicit) speciication of the
scheme. The value is |none| if the default port is explicitly not
defined. See also |default-port|, which is a subset of this field.
scriptable [boolean]
May contain insecure data within the URL.
secure [boolean]
Whether the protocol associated with the URL scheme is "secure" as
in RFC 6265 <https://tools.ietf.org/html/rfc6265#section-5.4> or
not.
url [string?]
Definition for the URL scheme, if any.
web-core [boolean]
Important URL schemes of the Web platform.
well-known [boolean]
Whether the /.well-known/ convention is defined to be applied or
not.
wildcard [boolean]
Wildcard "*" is used in URL scheme name. It is not a URL scheme but
a set of URL schemes sharing same name pattern.
with-tls [string?]
Name of a variant URL scheme (without ":" suffix) which shares the
same underlying protocol but using SSL/TLS or DTLS.
x-callback-url [boolean]
Whether the URL scheme supports x-callback-url
<http://x-callback-url.com/> or not.
* Sources
URL Standard <https://url.spec.whatwg.org/>.
Fetch Standard <https://fetch.spec.whatwg.org/>.
HTML Standard <https://www.whatwg.org/specs/web-apps/current-work/>.
Uniform Resource Identifier (URI) Schemes
<https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml>.
List of URL schemes
<https://suika.suikawiki.org/~wakaba/wiki/sw/n/List%20of%20URL%20schemes>.
iHasApp <https://github.com/danielamitay/iHasApp>.
* License
You are granted a license to use, reproduce, and create derivative
works of the JSON file.
Per CC0 <https://creativecommons.org/publicdomain/zero/1.0/>, to the
extent possible under law, the author of the JSON file and this
document has waived all copyright and related or neighboring rights to
the JSON file and this document.
The JSON file contains data derived from
<https://raw.githubusercontent.com/danielamitay/iHasApp/master/iHasApp/schemeApps.json>,
which is licensed with the MIT License
<https://github.com/danielamitay/iHasApp/blob/master/LICENSE.md>:
Copyright (c) 2012 Daniel Amitay (http://danielamitay.com)
Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation files
(the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software,
and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.