Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
JSON
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
* Some parts of this feature may have varying levels of support.
Resumo
O ObjetoJSON contém métodos para parsingJavaScript Object Notation (JSON) e conversão de valores para JSON. Ele não pode ser chamado ou construído e, além de suas propriedades de dois métodos, ele não possui uma funcionalidade interessante.
Descrição
JavaScript Object Notation
JSON é uma sintaxe para serialização de objetos, matrizes, números, strings, booleanos, enull. Baseia-se em sintaxe Javascript, mas é distinta desta: alguns Javascript não são JSON, e alguns JSON não são Javascript.
| JavaScript tipo | JSON diferenças |
|---|---|
| Objetos e Arrays | Os nomes das propriedades devem ser strings com aspas duplas; as vírgulas à direita são proibidas. |
| Números | Zeros à esquerda são proibidos; um ponto decimal deve ser seguido por pelo menos um dígito. |
| Strings | Apenas um conjunto limitado de caracteres pode ser escapado; certos caracteres de controle são proibidos; o separador de linha Unicode (U+2028) e o separador de parágrafo (U+2029) caracteres são permitidos; strings devem ter aspas duplas.Veja o exemplo a seguir, ondeJSON.parse() funciona bem e umSyntaxError é lançado ao avaliar o código como #"\u2028\u2029"'; JSON.parse(code); // works fine eval(code); // fails |
A sintaxe completa do JSON é a seguinte:
JSON = null or true or false or JSONNumber or JSONString or JSONObject or JSONArrayJSONNumber = - PositiveNumber or PositiveNumberPositiveNumber = DecimalNumber or DecimalNumber . Digits or DecimalNumber . Digits ExponentPart or DecimalNumber ExponentPartDecimalNumber = 0 or OneToNine DigitsExponentPart = e Exponent or E ExponentExponent = Digits or + Digits or - DigitsDigits = Digit or Digits DigitDigit = 0 through 9OneToNine = 1 through 9JSONString = "" or " StringCharacters "StringCharacters = StringCharacter or StringCharacters StringCharacterStringCharacter = any character except " or \ or U+0000 through U+001F or EscapeSequenceEscapeSequence = \" or \/ or \\ or \b or \f or \n or \r or \t or \u HexDigit HexDigit HexDigit HexDigitHexDigit = 0 through 9 or A through F or a through fJSONObject = { } or { Members }Members = JSONString : JSON or Members , JSONString : JSONJSONArray = [ ] or [ ArrayElements ]ArrayElements = JSON or ArrayElements , JSONEspaços em branco podem estar presentes em qualquer lugar, exceto dentro de um JSONNumber (números não devem conter espaço em branco) ou JSONString (onde ele é interpretado como o caractere correspondente na string, ou causaria um erro). O caractere de tabulação (U+0009), retorno de carro (U+000D), retorno de linha (U+000A), e espaço (U+0020) são os únicos caracteres em branco válidos.
Métodos
JSON.parse()Analisar uma seqüência como JSON, opcionalmente transformar o valor produzido e suas propriedades, e retornar o valor.
JSON.stringify()Retorna uma string JSON correspondente ao valor especificado, opcionalmente, pode incluir apenas determinados propriedades ou substituir valores de propriedade de acordo com a definição feita pelo usuário.
Polyfill
O objeto JSON não é suportado em navegadores mais antigos. Você pode contornar este problema inserindo o seguinte código no início de seus scripts, permitindo o uso de JSON e navegadores sem suporte (como Internet Explorer 6).
O algoritmo a seguir é uma imitação do objeto nativo JSON:
if (!window.JSON) { window.JSON = { parse: function (sJSON) { return eval("(" + sJSON + ")"); }, stringify: (function () { var toString = Object.prototype.toString; var isArray = Array.isArray || function (a) { return toString.call(a) === "[object Array]"; }; var escMap = { '"': '\\"', "\\": "\\\\", "\b": "\\b", "\f": "\\f", "\n": "\\n", "\r": "\\r", "\t": "\\t", }; var escFunc = function (m) { return ( escMap[m] || "\\u" + (m.charCodeAt(0) + 0x10000).toString(16).substr(1) ); }; var escRE = /[\\"\u0000-\u001F\u2028\u2029]/g; return function stringify(value) { if (value == null) { return "null"; } else if (typeof value === "number") { return isFinite(value) ? value.toString() : "null"; } else if (typeof value === "boolean") { return value.toString(); } else if (typeof value === "object") { if (typeof value.toJSON === "function") { return stringify(value.toJSON()); } else if (isArray(value)) { var res = "["; for (var i = 0; i < value.length; i++) res += (i ? ", " : "") + stringify(value[i]); return res + "]"; } else if (toString.call(value) === "[object Object]") { var tmp = []; for (var k in value) { if (value.hasOwnProperty(k)) tmp.push(stringify(k) + ": " + stringify(value[k])); } return "{" + tmp.join(", ") + "}"; } } return '"' + value.toString().replace(escRE, escFunc) + '"'; }; })(), };}Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-json-object |