Module: ActiveSupport::JSON
Relationships & Source Files | |
Defined in: | activesupport/lib/active_support/json/decoding.rb, activesupport/lib/active_support/json/encoding.rb |
Constant Summary
-
DATE_REGEX =
matches YAML-formatted dates
/^(?:\d{4}-\d{2}-\d{2}|\d{4}-\d{1,2}-\d{1,2}[T \t]+\d{1,2}:\d{2}:\d{2}(\.[0-9]*)?(([ \t]*)Z|[-+]\d{2}?(:\d{2})?))$/
Class Method Summary
-
.decode(json, options = {})
Parses a
JSON
string (JavaScript ::Object Notation) into a hash. -
.encode(value, options = nil)
Dumps objects in
JSON
(JavaScript ::Object Notation). -
.parse_error
Returns the class of the error that will be raised when there is an error in decoding
JSON
.
Class Method Details
.decode(json, options = {})
Parses a JSON
string (JavaScript ::Object Notation) into a hash. See www.json.org for more info.
ActiveSupport::JSON.decode("{\"team\":\"rails\",\"players\":\"36\"}")
#=> {"team" => "rails", "players" => "36"}
# File 'activesupport/lib/active_support/json/decoding.rb', line 19
def decode(json, = {}) if .present? raise ArgumentError, "In Rails 4.1, ActiveSupport::JSON.decode no longer " \ "accepts an options hash for MultiJSON. MultiJSON reached its end of life " \ "and has been removed." end data = ::JSON.parse(json, quirks_mode: true) if ActiveSupport.parse_json_times convert_dates_from(data) else data end end
.encode(value, options = nil)
Dumps objects in JSON
(JavaScript ::Object Notation). See www.json.org for more info.
ActiveSupport::JSON.encode({ team: 'rails', players: '36' })
# => "{\"team\":\"rails\",\"players\":\"36\"}"
# File 'activesupport/lib/active_support/json/encoding.rb', line 21
def self.encode(value, = nil) Encoding.json_encoder.new( ).encode(value) end
.parse_error
Returns the class of the error that will be raised when there is an error in decoding JSON
. Using this method means you won't directly depend on the ActiveSupport's JSON
implementation, in case it changes in the future.
begin
obj = ActiveSupport::JSON.decode(some_string)
rescue ActiveSupport::JSON.parse_error
Rails.logger.warn("Attempted to decode invalid JSON: #{some_string}")
end
# File 'activesupport/lib/active_support/json/decoding.rb', line 45
def parse_error ::JSON::ParserError end