Método JSON stringify() do JavaScript
- Página anterior parse()
- Próxima página parse()
- Voltar à página anterior Manual de Referência JavaScript JSON
Definição e uso
O método JSON.stringify() converte um objeto JavaScript em uma string.
Quando os dados são enviados para o servidor web, os dados devem ser uma string.
Exemplo
Exemplo 1
Stringificar objeto JavaScript:
var obj = { "name":"Bill", "age":19, "city":"Seattle"}; var myJSON = JSON.stringify(obj); document.getElementById("demo").innerHTML = myJSON;
Exemplo 2
Use a função de substituição:
/* Substitua o valor "city" por maiúsculas:*/ var obj = { "name":"Bill", "age":"19", "city":"Seattle"}; var text = JSON.stringify(obj, function (key, value) { if (key == "city") { return value.toUpperCase(); } else { return value; } });
Exemplo 3
Uso espaço Parâmetros:
/* Insira 10 espaços em branco para cada espaço:*/ var obj = { "name":"Bill", "age":"19", "city":"Seattle"}; var text = JSON.stringify(obj, null, 10);
Exemplo 4
Uso espaço Parâmetros:
/* Insira a palavra SPACE para cada espaço:*/ var obj = { "name":"Bill", "age":"19", "city":"Seattle"}; var text = JSON.stringify(obj, null, "SPACE");
Sintaxe
JSON.stringify(obj, replacer, espaço)
Valor do parâmetro
Parâmetro | Descrição |
---|---|
obj | Obrigatório. Valor a ser convertido em string. |
replacer |
Opcional. Função ou array usado para transformar o resultado. Se o parâmetro for uma função, em processo de serialização, cada atributo do valor a ser serializado será transformado e processado por essa função; Se o parâmetro for um array, apenas os nomes dos atributos contidos nesse array serão serializados para a string JSON final; Se o parâmetro for null ou não fornecido, todos os atributos do objeto serão serializados. |
espaço |
Opcional. Valor de string ou número. Especifica a string de espaço em branco usada para alinhar a saída (pretty-print). Se o parâmetro for um número, ele representa quantos espaços; o limite é 10. Se esse valor for menor que 1, significa que não há espaços; Se o parâmetro for uma string (quando o comprimento da string for maior que 10 letras, pega as primeiras 10 letras),a string será usada como espaço; Se o parâmetro não for fornecido (ou for null),não haverá espaços. |
Detalhes técnicos
Valor retornado: | Uma String |
---|---|
Versão do JavaScript: | ECMAScript 5 |
Suporte do navegador
Os números na tabela indicam a primeira versão do navegador que suporta completamente o método.
Métodos | Chrome | IE | Firefox | Safari | Opera |
---|---|---|---|---|---|
stringify() | 4.0 | 8.0 | 3.5 | 4.0 | 11.5 |
Páginas relacionadas
Tutorial de JSON:Introdução ao JSON
- Página anterior parse()
- Próxima página parse()
- Voltar à página anterior Manual de Referência JavaScript JSON