A parsed URI, such as a URL.
See also:
- URIs in the library tour
- RFC-3986
Static Properties
Static Methods
-
decodeComponent(
String encodedComponent) → String -
Decodes the percent-encoding in
encodedComponent
. -
decodeFull(
String uri) → String -
Decodes the percent-encoding in
uri
. -
decodeQueryComponent(
String encodedComponent, {Encoding encoding: UTF8}) → String -
Decodes the percent-encoding in
encodedComponent
, converting pluses to spaces. -
encodeComponent(
String component) → String -
Encode the string
component
using percent-encoding to make it safe for literal use as a URI component. -
encodeFull(
String uri) → String -
Encode the string
uri
using percent-encoding to make it safe for literal use as a full URI. -
encodeQueryComponent(
String component, {Encoding encoding: UTF8}) → String -
Encode the string
component
according to the HTML 4.01 rules for encoding the posting of a HTML form as a query string component. -
parse(
String uri, [int start = 0, int end]) → Uri -
Creates a new
Uri
object by parsing a URI string. -
parseIPv4Address(
String host) → List<int> -
Parse the
host
as an IP version 4 (IPv4) address, returning the address as a list of 4 bytes in network byte order (big endian). -
parseIPv6Address(
String host, [int start = 0, int end]) → List<int> -
Parse the
host
as an IP version 6 (IPv6) address, returning the address as a list of 16 bytes in network byte order (big endian). -
splitQueryString(
String query, {Encoding encoding: UTF8}) → Map<String,String> -
Returns the
query
split into a map according to the rules specified for FORM post in the HTML 4.01 specification section 17.13.4. Each key and value in the returned map has been decoded. If thequery
is the empty string an empty map is returned.
Properties
-
read-onlyReturns the authority component.
- String fragment
-
read-onlyReturns the fragment identifier component.
- bool hasAbsolutePath
-
read-onlyReturns whether the URI has an absolute path (starting with '/').
- bool hasAuthority
-
read-onlyReturns whether the URI has an
authority
component. - bool hasEmptyPath
-
read-onlyReturns whether the URI has an empty path.
- bool hasFragment
-
read-onlyReturns whether the URI has a fragment part.
- int hashCode
-
read-only
- bool hasPort
-
read-onlyReturns whether the URI has an explicit port.
- bool hasQuery
-
read-onlyReturns whether the URI has a query part.
- bool hasScheme
-
read-onlyReturns whether the URI has a
scheme
component. - String host
-
read-onlyReturns the host part of the authority component.
- bool isAbsolute
-
read-onlyReturns whether the URI is absolute.
- String origin
-
read-onlyReturns the origin of the URI in the form scheme://host:port for the schemes http and https.
- String path
-
read-onlyReturns the path component.
- List<String> pathSegments
-
read-onlyReturns the URI path split into its segments. Each of the segments in the returned list have been decoded. If the path is empty the empty list will be returned. A leading slash
/
does not affect the segments returned. - int port
-
read-onlyReturns the port part of the authority component.
- String query
-
read-onlyReturns the query component. The returned query is encoded. To get direct access to the decoded query use
queryParameters
. - Map<String,String> queryParameters
-
read-onlyReturns the URI query split into a map according to the rules specified for FORM post in the HTML 4.01 specification section 17.13.4. Each key and value in the returned map has been decoded. If there is no query the empty map is returned.
- String scheme
-
read-onlyReturns the scheme component.
- String userInfo
-
read-onlyReturns the user info part of the authority component.
Constructors
- Uri({String scheme: "", String userInfo: "", String host, int port, String path, Iterable<String> pathSegments, String query, Map<String,String> queryParameters, String fragment})
- Creates a new URI from its components.
- Uri.directory(String path, {bool windows})
-
Like
Uri.file
except that a non-empty URI path ends in a slash. - Uri.file(String path, {bool windows})
- Creates a new file URI from an absolute or relative file path.
- Uri.http(String authority, String unencodedPath, [Map<String,String> queryParameters])
-
Creates a new
http
URI from authority, path and query. - Uri.https(String authority, String unencodedPath, [Map<String,String> queryParameters])
-
Creates a new
https
URI from authority, path and query.
Operators
-
operator ==(
other) → bool - The equality operator.
Methods
-
normalizePath(
) → Uri - Returns a URI where the path has been normalized.
-
replace(
{String scheme, String userInfo, String host, int port, String path, Iterable<String> pathSegments, String query, Map<String,String> queryParameters, String fragment}) → Uri -
Returns a new
Uri
based on this one, but with some parts replaced. -
resolve(
String reference) → Uri -
Resolve
reference
as an URI relative tothis
. -
resolveUri(
Uri reference) → Uri -
Resolve
reference
as an URI relative tothis
. -
toFilePath(
{bool windows}) → String - Returns the file path from a file URI.
-
toString(
) → String - Returns a string representation of this object.