rseJSON() | JQuery API Documentation

jQuery API Documentation

Navigation

• Download
• API Documentation
• Blog
• Plugins
• Browser Support
• Version Support

jQuery.parseJSON( json )Returns: String or Number or Object or Array or Booleanversion deprecated: 3.0, removed: 4.0

Description: Takes a well-formed JSON string and returns the resulting JavaScript value.

• version added: 1.4.1jQuery.parseJSON( json )

  • json Type: String The JSON string to parse.

As of jQuery 3.0, $.parseJSON is deprecated. To parse JSON strings use the native JSON.parse method instead.

Passing in a malformed JSON string results in a JavaScript exception being thrown. For example, the following are all invalid JSON strings:

• "{test: 1}" (test does not have double quotes around it).
• "{'test': 1}" ('test' is using single quotes instead of double quotes).
• "'test'" ('test' is using single quotes instead of double quotes).
• ".1" (a number must start with a digit; "0.1" would be valid).
• "undefined" (undefined cannot be represented in a JSON string; null, however, can be).
• "NaN" (NaN cannot be represented in a JSON string; direct representation of Infinity is also not permitted).

The JSON standard does not permit "control characters" such as a tab or newline. An example like $.parseJSON( '{ "testing":"1\t2\n3" }' ) will throw an error in most implementations because the JavaScript parser converts the string's tab and newline escapes into literal tab and newline; doubling the backslashes like "1\\t2\\n3" yields expected results. This problem is often seen when injecting JSON into a JavaScript file from a server-side language such as PHP.

Where the browser provides a native implementation of JSON.parse, jQuery uses it to parse the string. For details on the JSON format, see https://json.org/.

Prior to jQuery 1.9, $.parseJSON returned null instead of throwing an error if it was passed an empty string, null, or undefined, even though those are not valid JSON.

Parse a JSON string.

1 2	var obj = jQuery.parseJSON( '{ "name": "John" }' );alert( obj.name === "John" );

• Ajax
  • Global Ajax Event Handlers
  • Helper Functions
  • Low-Level Interface
  • Shorthand Methods
• Attributes
• Callbacks Object
• Core
• CSS
• Data
• Deferred Object
• Deprecated
  • Deprecated 1.3
  • Deprecated 1.7
  • Deprecated 1.8
  • Deprecated 1.9
  • Deprecated 1.10 & 2.0
  • Deprecated 3.0
  • Deprecated 3.2
  • Deprecated 3.3
  • Deprecated 3.4
  • Deprecated 3.5
  • Deprecated 3.7
• Dimensions
• Effects
  • Basics
  • Custom
  • Fading
  • Sliding
• Events
  • Browser Events
  • Document Loading
  • Event Handler Attachment
  • Event Object
  • Form Events
  • Keyboard Events
  • Mouse Events
• Forms
• Internals
• Manipulation
  • Class Attribute
  • Copying
  • DOM Insertion, Around
  • DOM Insertion, Inside
  • DOM Insertion, Outside
  • DOM Removal
  • DOM Replacement
  • General Attributes
  • Style Properties
• Miscellaneous
  • Collection Manipulation
  • Data Storage
  • DOM Element Methods
  • Setup Methods
• Offset
• Properties
  • Properties of jQuery Object Instances
  • Properties of the Global jQuery Object
• Removed
• Selectors
  • Attribute
  • Basic
  • Basic Filter
  • Child Filter
  • Content Filter
  • Form
  • Hierarchy
  • jQuery Extensions
  • Visibility Filter
• Traversing
  • Filtering
  • Miscellaneous Traversing
  • Tree Traversal
• Utilities
• Version
  • Version 1.0
  • Version 1.0.4
  • Version 1.1
  • Version 1.1.2
  • Version 1.1.3
  • Version 1.1.4
  • Version 1.2
  • Version 1.2.3
  • Version 1.2.6
  • Version 1.3
  • Version 1.4
  • Version 1.4.1
  • Version 1.4.2
  • Version 1.4.3
  • Version 1.4.4
  • Version 1.5
  • Version 1.5.1
  • Version 1.6
  • Version 1.7
  • Version 1.8
  • Version 1.9
  • Version 1.11 & 2.1
  • Version 1.12 & 2.2
  • Version 3.0
  • Version 3.1
  • Version 3.2
  • Version 3.3
  • Version 3.4
  • Version 3.5
  • Version 3.6
  • Version 3.7
  • Version 4.0