ObjectUrlObject
UrlObject é un obxecto que se usa para representar información de URL. Podemos usar facilmente obxectos UrlObject para representar e manexar un enderezo URL.
UrlObject encapsula moitos métodos e propiedades útiles, como métodos de análise e formato, que poden analizar e formatar URL rapidamente.
Para os obxectos UrlObject, podemos crealos das seguintes formas:
- usarurlStringCreateUrlObject. Neste método, parse analiza automaticamente o URL. Se o URL é ilegal, lanzarase unha excepción:
1
2
3
4const url = require('url');
const parsedURL = url.parse('https://www.google.com');
console.log(parsedURL);
- Crear UrlObject usando parámetros de construción:
1
2
3
4
5
6
7
8
9
10
11
12const url = require('url');
const parsedURL = new url.URL({
protocol: 'https:',
hostname: 'www.google.com',
pathname: '/search',
query: {
q: 'hello world',
}
});
console.log(parsedURL);
relación de herdanza
Construtor
UrlObject
Construtor de obxectos UrlObject, construído usando parámetros
1new UrlObject(Object args);
Parámetros de chamada:
- args: Obxecto, un obxecto de dicionario que especifica os parámetros de construción. Os campos admitidos son: protocolo, barras inclinadas, nome de usuario, contrasinal, nome de host, porto, ruta, consulta,hash
Construtor de obxectos UrlObject, usourlConstrución de cordas
1
2
3new UrlObject(String url = "",
Boolean parseQueryString = false,
Boolean slashesDenoteHost = false);
Parámetros de chamada:
- url: String, constructor especificadourlcorda
- parseQueryString: Booleano, especifica se analizar a consulta
- slashesDenoteHost: Booleano, o valor predeterminado é falso, se se define como verdadeiro, a cadea despois da cadea '//' e antes do seguinte '/' analizarase como host, como '//foo/bar', o resultado debería ser { host : 'foo', pathname: '/bar'} en lugar de {pathname: '//foo/bar'}
propiedades dos membros
href
Cadena, consulta e establece a cadea completa no obxecto UrlObject actualurlA descrición do enderezo, que se ensambla a partir de todas as outras propiedades
1String UrlObject.href;
protocol
Encadea, consulta e establece o nome do protocolo no obxecto UrlObject actual
1String UrlObject.protocol;
slashes
Booleano, consulta e establece se o obxecto UrlObject actual contén barras inclinadas dobres
1Boolean UrlObject.slashes;
auth
Cadea, consulta e establece a cadea de verificación completa no obxecto UrlObject actual, reunido a partir dos atributos de nome de usuario e contrasinal
1String UrlObject.auth;
username
Encadea, consulta e establece o usuario autenticado no obxecto UrlObject actual
1String UrlObject.username;
password
Encadea, consulta e establece o contrasinal de verificación no obxecto UrlObject actual
1String UrlObject.password;
host
Encadea, consulta e establece a descrición completa do host no obxecto UrlObject actual, ensamblado por hastname e porto
1String UrlObject.host;
hostname
Encadea, consulta e establece o nome de host no obxecto UrlObject actual
1String UrlObject.hostname;
port
Cadena, consulta e establece o número de porto no obxecto UrlObject actual
1String UrlObject.port;
path
Encadea, consulta e establece a ruta de solicitude completa (incluída a solicitude) no obxecto UrlObject actual, ensamblado a partir do nome de ruta e da consulta
1String UrlObject.path;
pathname
Cadena, consulta e establece a ruta no obxecto UrlObject actual
1String UrlObject.pathname;
search
Cadea, consulta e establece a cadea de solicitude (incluíndo "?") no obxecto UrlObject actual, equivalente a "?" + consulta
1String UrlObject.search;
query
Valora, consulta e establece a cadea de solicitude no obxecto UrlObject actual (excluíndo "?")
1Value UrlObject.query;
hash
Cadena, consulta e establece o punto de ancoraxe da solicitude no obxecto UrlObject actual (incluíndo "#")
1String UrlObject.hash;
searchParams
HttpCollection, Consulta a cadea de solicitude no obxecto UrlObject actual (excluíndo "?")
1readonly HttpCollection UrlObject.searchParams;
función de membro
parse
Analizar aurlcorda
1
2
3UrlObject.parse(String url,
Boolean parseQueryString = false,
Boolean slashesDenoteHost = false);
Parámetros de chamada:
- url: Cadea, especifica o que se debe analizarurlcorda
- parseQueryString: Booleano, especifica se analizar a consulta
- slashesDenoteHost: Booleano, o valor predeterminado é falso, se se define como verdadeiro, a cadea despois da cadea '//' e antes do seguinte '/' analizarase como host, como '//foo/bar', o resultado debería ser { host : 'foo', pathname: '/bar'} en lugar de {pathname: '//foo/bar'}
format
Constrúe UrlObject cos parámetros especificados
1UrlObject.format(Object args);
Parámetros de chamada:
- args: Obxecto, un obxecto de dicionario que especifica os parámetros de construción. Os campos admitidos son: protocolo, barras inclinadas, nome de usuario, contrasinal, nome de host, porto, ruta, consulta,hash
resolve
restablecerurlCamiño, identifica automaticamente se o novo camiño é un camiño relativo ou un camiño absoluto
1UrlObject UrlObject.resolve(String url);
Parámetros de chamada:
- url: Cadea, especifique o novo camiño
Resultados de devolución:
- UrlObject, devolve un obxecto que contén datos de traslado
normalize
camiño normalizado
1UrlObject.normalize();
toString
Devolve a representación en cadea do obxecto. Polo xeral, devólvese "[Obxecto nativo]". O obxecto pódese volver implementar segundo as súas propias características.
1String UrlObject.toString();
Resultados de devolución:
- String, devolve a representación en cadea do obxecto
toJSON
Devolve unha representación en formato JSON do obxecto, devolvendo xeralmente unha colección de propiedades lexibles definidas polo obxecto.
1Value UrlObject.toJSON(String key = "");
Parámetros de chamada:
- key: Cadena, non usada
Resultados de devolución:
- Value, devolve un valor que contén JSON serializable