new URLSearchParams( [query])
Classe auxiliar para a manipulação da query string de uma URL, baseado na classe original especificada nas Web APIs do Mozilla Developer Network.
Parameters:
Name | Type | Argument | Description |
---|---|---|---|
query |
string | Array.<Array.<string>> | Record.<string, string> |
<optional> |
Uma query string, ou um array cujos elementos são também arrays contendo um par [nome, valor], ou um objeto correspondendo a um mapa de nomes e valores. |
Example
const URLSearchParams = require('@nginstack/engine/lib/url/URLSearchParams.js'); var params1 = new URLSearchParams('name=value'); var params2 = new URLSearchParams([['name', value'], ['other', 'value2']]); var params3 = new URLSearchParams({name: "value"});
Methods
-
append(name, value)
-
Adiciona um parâmetro à lista
Parameters:
Name Type Description name
string o nome do parâmetro
value
* o valor do parâmetro
-
delete(name)
-
Remove um parâmetro da lista
Parameters:
Name Type Description name
string nome do parâmetro
-
forEach(callback, thisArg)
-
Itera sobre todos os parâmetros
Parameters:
Name Type Description callback
function Função chamada para cada parâmetro
thisArg
Object this usado na invocação de callback
-
get(name)
-
Retorna o valor associado a um parâmetro
Parameters:
Name Type Description name
string Nome do parâmetro
Returns:
o primeiro valor associado ao parâmetro, ou null se ele não existir
- Type
- *
-
getAll(name)
-
Retorna todos os valores associados a um parâmetro
Parameters:
Name Type Description name
string Nome do parâmetro
Returns:
todos os valores associados ao parâmetro name
- Type
- Array
-
has(name)
-
Parameters:
Name Type Description name
string nome do parâmetro
Returns:
true se o parâmetro existe
- Type
- boolean
-
set(name, value)
-
Atribui um valor a um parâmetro
Parameters:
Name Type Description name
string Nome do parâmetro
value
* valor do parâmetro
-
toString()
-
Returns:
Query string, sem o '?'
- Type
- string