Método JSON stringify() do JavaScript

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;

Experimente você mesmo

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;
  }
});

Experimente você mesmo

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);

Experimente você mesmo

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");

Experimente você mesmo

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