cadena de consulta del mòdul

El mòdul querystring ofereix algunes funcions pràctiques per analitzar i serialitzar els paràmetres de consulta d'URL. Amb el mòdul querystring, podeu analitzar fàcilment els paràmetres de consulta d'URL en objectes o cadenes, i també podeu serialitzar objectes en cadenes de paràmetres de consulta d'URL.

Les següents són querystringles funcions d'ús habitual del mòdul:

• querystring.parse(str[, sep[, eq[, options]]]): analitza els paràmetres de consulta d'URL en objectes
• querystring.stringify(obj[, sep[, eq[, options]]]): serialitza l'objecte en una cadena de paràmetres de consulta d'URL

Entre ells, strhi ha la cadena de paràmetres de consulta d'URL que s'ha d'analitzar i objés l'objecte que s'ha de serialitzar.

L'exemple següent mostra com utilitzar querystringel mòdul per analitzar els paràmetres de consulta d'un URL en objectes:

1
2
3
4
5
6
7
8
const querystring = require('querystring');

const url = 'https://www.example.com/path/to/page?foo=bar&baz=qux';

const search = new URL(url).search; // return '?foo=bar&baz=qux'
const query = querystring.parse(search.slice(1)); // parse query string

console.log(query); // output { foo: 'bar', baz: 'qux' }

El codi anterior obté primer un URL, després n'extreu la part del paràmetre de consulta, utilitza querystring.parse()la funció per analitzar-lo en un objecte i, finalment, imprimeix l'objecte.

A continuació, un exemple mostra com utilitzar querystringel mòdul per serialitzar un objecte en una cadena de paràmetres de consulta d'URL:

1
2
3
4
5
6
7
8
9
10
const querystring = require('querystring');

const obj = {
    foo: 'bar',
    baz: 'qux'
};

const query = querystring.stringify(obj);

console.log(query); // output "foo=bar&baz=qux"

Al codi anterior, primer es defineix un objecte, després querystring.stringify()s'utilitza la funció per serialitzar-lo en una cadena de paràmetres de consulta d'URL i, finalment, s'imprimeix la cadena.

Es pot trobar que l'ús querystringdel mòdul pot analitzar i serialitzar fàcilment els paràmetres de consulta d'URL, reduint el processament feixuc de les cadenes i millorant la llegibilitat i el manteniment del codi.

funció estàtica

escape

urlCodificació de seguretat de cadena parcial

1
static String querystring.escape(String str);

Paràmetres de trucada:

• str: Cadena, per codificarurl

Resultats de retorn:

• String, retorna la cadena codificada

---

unescape

urlDescodificació segura de cadenes

1
static String querystring.unescape(String str);

Paràmetres de trucada:

• str: Cadena, per descodificarurl

Resultats de retorn:

• String, retorna la cadena descodificada

---

parse

Analitzar la cadena de consulta

1
2
3
4
static HttpCollection querystring.parse(String str,
    String sep = "&",
    String eq = "=",
    Object opt = {});

Paràmetres de trucada:

• str: String, la cadena que s'ha d'analitzar
• sep: String, la cadena dividida utilitzada durant l'anàlisi, el valor per defecte és &
• eq: String, la cadena d'assignació utilitzada durant l'anàlisi, el valor per defecte és =
• opt: Objecte, paràmetres d'anàlisi, encara no compatible

Resultats de retorn:

• HttpCollection, retorna l'objecte descodificat

---

stringify

Serialitzar un objecte en una cadena de consulta

1
2
3
4
static String querystring.stringify(Object obj,
    String sep = "&",
    String eq = "=",
    Object opt = {});

Paràmetres de trucada:

• obj: Objecte, l'objecte a serialitzar
• sep: String, la cadena dividida utilitzada durant la serialització, el valor per defecte és &
• eq: String, la cadena d'assignació utilitzada durant la serialització, el valor per defecte és =
• opt: Objecte, paràmetres d'anàlisi, encara no compatible

Resultats de retorn:

• String, retorna la cadena serialitzada