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 namestring o nome do parâmetro
value* o valor do parâmetro
-
delete(name)
-
Remove um parâmetro da lista
Parameters:
Name Type Description namestring nome do parâmetro
-
forEach(callback, thisArg)
-
Itera sobre todos os parâmetros
Parameters:
Name Type Description callbackfunction Função chamada para cada parâmetro
thisArgObject this usado na invocação de callback
-
get(name)
-
Retorna o valor associado a um parâmetro
Parameters:
Name Type Description namestring 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 namestring Nome do parâmetro
Returns:
todos os valores associados ao parâmetro name
- Type
- Array
-
has(name)
-
Parameters:
Name Type Description namestring 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 namestring Nome do parâmetro
value* valor do parâmetro
-
toString()
-
Returns:
Query string, sem o '?'
- Type
- string