1 // Copyright 2011 the V8 project authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef V8_JSON_PARSER_H_
6 #define V8_JSON_PARSER_H_
10 #include "src/char-predicates-inl.h"
11 #include "src/conversions.h"
12 #include "src/heap/spaces-inl.h"
13 #include "src/messages.h"
14 #include "src/token.h"
19 // A simple json parser.
20 template <bool seq_one_byte>
21 class JsonParser BASE_EMBEDDED {
23 MUST_USE_RESULT static MaybeHandle<Object> Parse(Handle<String> source) {
24 return JsonParser(source).ParseJson();
27 static const int kEndOfString = -1;
30 explicit JsonParser(Handle<String> source)
32 source_length_(source->length()),
33 isolate_(source->map()->GetHeap()->isolate()),
34 factory_(isolate_->factory()),
36 object_constructor_(isolate_->native_context()->object_function(),
39 source_ = String::Flatten(source_);
40 pretenure_ = (source_length_ >= kPretenureTreshold) ? TENURED : NOT_TENURED;
42 // Optimized fast case where we only have Latin1 characters.
44 seq_source_ = Handle<SeqOneByteString>::cast(source_);
48 // Parse a string containing a single JSON value.
49 MaybeHandle<Object> ParseJson();
51 inline void Advance() {
53 if (position_ >= source_length_) {
55 } else if (seq_one_byte) {
56 c0_ = seq_source_->SeqOneByteStringGet(position_);
58 c0_ = source_->Get(position_);
62 // The JSON lexical grammar is specified in the ECMAScript 5 standard,
63 // section 15.12.1.1. The only allowed whitespace characters between tokens
64 // are tab, carriage-return, newline and space.
66 inline void AdvanceSkipWhitespace() {
69 } while (c0_ == ' ' || c0_ == '\t' || c0_ == '\n' || c0_ == '\r');
72 inline void SkipWhitespace() {
73 while (c0_ == ' ' || c0_ == '\t' || c0_ == '\n' || c0_ == '\r') {
78 inline uc32 AdvanceGetChar() {
83 // Checks that current charater is c.
84 // If so, then consume c and skip whitespace.
85 inline bool MatchSkipWhiteSpace(uc32 c) {
87 AdvanceSkipWhitespace();
93 // A JSON string (production JSONString) is subset of valid JavaScript string
94 // literals. The string must only be double-quoted (not single-quoted), and
95 // the only allowed backslash-escapes are ", /, \, b, f, n, r, t and
96 // four-digit hex escapes (uXXXX). Any other use of backslashes is invalid.
97 Handle<String> ParseJsonString() {
98 return ScanJsonString<false>();
101 bool ParseJsonString(Handle<String> expected) {
102 int length = expected->length();
103 if (source_->length() - position_ - 1 > length) {
104 DisallowHeapAllocation no_gc;
105 String::FlatContent content = expected->GetFlatContent();
106 if (content.IsOneByte()) {
108 const uint8_t* input_chars = seq_source_->GetChars() + position_ + 1;
109 const uint8_t* expected_chars = content.ToOneByteVector().start();
110 for (int i = 0; i < length; i++) {
111 uint8_t c0 = input_chars[i];
112 if (c0 != expected_chars[i] ||
113 c0 == '"' || c0 < 0x20 || c0 == '\\') {
117 if (input_chars[length] == '"') {
118 position_ = position_ + length + 1;
119 AdvanceSkipWhitespace();
127 Handle<String> ParseJsonInternalizedString() {
128 return ScanJsonString<true>();
131 template <bool is_internalized>
132 Handle<String> ScanJsonString();
133 // Creates a new string and copies prefix[start..end] into the beginning
134 // of it. Then scans the rest of the string, adding characters after the
135 // prefix. Called by ScanJsonString when reaching a '\' or non-Latin1 char.
136 template <typename StringType, typename SinkChar>
137 Handle<String> SlowScanJsonString(Handle<String> prefix, int start, int end);
139 // A JSON number (production JSONNumber) is a subset of the valid JavaScript
140 // decimal number literals.
141 // It includes an optional minus sign, must have at least one
142 // digit before and after a decimal point, may not have prefixed zeros (unless
143 // the integer part is zero), and may include an exponent part (e.g., "e-10").
144 // Hexadecimal and octal numbers are not allowed.
145 Handle<Object> ParseJsonNumber();
147 // Parse a single JSON value from input (grammar production JSONValue).
148 // A JSON value is either a (double-quoted) string literal, a number literal,
149 // one of "true", "false", or "null", or an object or array literal.
150 Handle<Object> ParseJsonValue();
152 // Parse a JSON object literal (grammar production JSONObject).
153 // An object literal is a squiggly-braced and comma separated sequence
154 // (possibly empty) of key/value pairs, where the key is a JSON string
155 // literal, the value is a JSON value, and the two are separated by a colon.
156 // A JSON array doesn't allow numbers and identifiers as keys, like a
158 Handle<Object> ParseJsonObject();
160 // Parses a JSON array literal (grammar production JSONArray). An array
161 // literal is a square-bracketed and comma separated sequence (possibly empty)
163 // A JSON array doesn't allow leaving out values from the sequence, nor does
164 // it allow a terminal comma, like a JavaScript array does.
165 Handle<Object> ParseJsonArray();
168 // Mark that a parsing error has happened at the current token, and
169 // return a null handle. Primarily for readability.
170 inline Handle<Object> ReportUnexpectedCharacter() {
171 return Handle<Object>::null();
174 inline Isolate* isolate() { return isolate_; }
175 inline Factory* factory() { return factory_; }
176 inline Handle<JSFunction> object_constructor() { return object_constructor_; }
178 static const int kInitialSpecialStringLength = 1024;
179 static const int kPretenureTreshold = 100 * 1024;
183 Zone* zone() { return &zone_; }
185 Handle<String> source_;
187 Handle<SeqOneByteString> seq_source_;
189 PretenureFlag pretenure_;
193 Handle<JSFunction> object_constructor_;
198 template <bool seq_one_byte>
199 MaybeHandle<Object> JsonParser<seq_one_byte>::ParseJson() {
200 // Advance to the first character (possibly EOS)
201 AdvanceSkipWhitespace();
202 Handle<Object> result = ParseJsonValue();
203 if (result.is_null() || c0_ != kEndOfString) {
204 // Some exception (for example stack overflow) is already pending.
205 if (isolate_->has_pending_exception()) return Handle<Object>::null();
207 // Parse failed. Current character is the unexpected token.
209 Factory* factory = this->factory();
210 Handle<JSArray> array;
214 message = "unexpected_eos";
215 array = factory->NewJSArray(0);
228 message = "unexpected_token_number";
229 array = factory->NewJSArray(0);
232 message = "unexpected_token_string";
233 array = factory->NewJSArray(0);
236 message = "unexpected_token";
237 Handle<Object> name = factory->LookupSingleCharacterStringFromCode(c0_);
238 Handle<FixedArray> element = factory->NewFixedArray(1);
239 element->set(0, *name);
240 array = factory->NewJSArrayWithElements(element);
244 MessageLocation location(factory->NewScript(source_),
247 Handle<Object> error;
248 ASSIGN_RETURN_ON_EXCEPTION(isolate(), error,
249 factory->NewSyntaxError(message, array), Object);
250 return isolate()->template Throw<Object>(error, &location);
256 // Parse any JSON value.
257 template <bool seq_one_byte>
258 Handle<Object> JsonParser<seq_one_byte>::ParseJsonValue() {
259 StackLimitCheck stack_check(isolate_);
260 if (stack_check.HasOverflowed()) {
261 isolate_->StackOverflow();
262 return Handle<Object>::null();
265 if (c0_ == '"') return ParseJsonString();
266 if ((c0_ >= '0' && c0_ <= '9') || c0_ == '-') return ParseJsonNumber();
267 if (c0_ == '{') return ParseJsonObject();
268 if (c0_ == '[') return ParseJsonArray();
270 if (AdvanceGetChar() == 'a' && AdvanceGetChar() == 'l' &&
271 AdvanceGetChar() == 's' && AdvanceGetChar() == 'e') {
272 AdvanceSkipWhitespace();
273 return factory()->false_value();
275 return ReportUnexpectedCharacter();
278 if (AdvanceGetChar() == 'r' && AdvanceGetChar() == 'u' &&
279 AdvanceGetChar() == 'e') {
280 AdvanceSkipWhitespace();
281 return factory()->true_value();
283 return ReportUnexpectedCharacter();
286 if (AdvanceGetChar() == 'u' && AdvanceGetChar() == 'l' &&
287 AdvanceGetChar() == 'l') {
288 AdvanceSkipWhitespace();
289 return factory()->null_value();
291 return ReportUnexpectedCharacter();
293 return ReportUnexpectedCharacter();
297 // Parse a JSON object. Position must be right at '{'.
298 template <bool seq_one_byte>
299 Handle<Object> JsonParser<seq_one_byte>::ParseJsonObject() {
300 HandleScope scope(isolate());
301 Handle<JSObject> json_object =
302 factory()->NewJSObject(object_constructor(), pretenure_);
303 Handle<Map> map(json_object->map());
304 ZoneList<Handle<Object> > properties(8, zone());
307 bool transitioning = true;
309 AdvanceSkipWhitespace();
312 if (c0_ != '"') return ReportUnexpectedCharacter();
314 int start_position = position_;
318 if (c0_ >= '0' && c0_ <= '9') {
319 // Maybe an array index, try to parse it.
321 // With a leading zero, the string has to be "0" only to be an index.
326 if (index > 429496729U - ((d > 5) ? 1 : 0)) break;
327 index = (index * 10) + d;
329 } while (c0_ >= '0' && c0_ <= '9');
333 // Successfully parsed index, parse and store element.
334 AdvanceSkipWhitespace();
336 if (c0_ != ':') return ReportUnexpectedCharacter();
337 AdvanceSkipWhitespace();
338 Handle<Object> value = ParseJsonValue();
339 if (value.is_null()) return ReportUnexpectedCharacter();
341 JSObject::SetOwnElement(json_object, index, value, SLOPPY).Assert();
344 // Not an index, fallback to the slow path.
347 position_ = start_position;
353 Handle<Object> value;
355 // Try to follow existing transitions as long as possible. Once we stop
356 // transitioning, no transition can be found anymore.
358 // First check whether there is a single expected transition. If so, try
359 // to parse it first.
360 bool follow_expected = false;
363 key = Map::ExpectedTransitionKey(map);
364 follow_expected = !key.is_null() && ParseJsonString(key);
366 // If the expected transition hits, follow it.
367 if (follow_expected) {
368 target = Map::ExpectedTransitionTarget(map);
370 // If the expected transition failed, parse an internalized string and
371 // try to find a matching transition.
372 key = ParseJsonInternalizedString();
373 if (key.is_null()) return ReportUnexpectedCharacter();
375 target = Map::FindTransitionToField(map, key);
376 // If a transition was found, follow it and continue.
377 transitioning = !target.is_null();
379 if (c0_ != ':') return ReportUnexpectedCharacter();
381 AdvanceSkipWhitespace();
382 value = ParseJsonValue();
383 if (value.is_null()) return ReportUnexpectedCharacter();
386 int descriptor = map->NumberOfOwnDescriptors();
387 PropertyDetails details =
388 target->instance_descriptors()->GetDetails(descriptor);
389 Representation expected_representation = details.representation();
391 if (value->FitsRepresentation(expected_representation)) {
392 if (expected_representation.IsDouble()) {
393 value = Object::NewStorageFor(isolate(), value,
394 expected_representation);
395 } else if (expected_representation.IsHeapObject() &&
396 !target->instance_descriptors()->GetFieldType(
397 descriptor)->NowContains(value)) {
398 Handle<HeapType> value_type(value->OptimalType(
399 isolate(), expected_representation));
400 Map::GeneralizeFieldType(target, descriptor, value_type);
402 DCHECK(target->instance_descriptors()->GetFieldType(
403 descriptor)->NowContains(value));
404 properties.Add(value, zone());
408 transitioning = false;
412 // Commit the intermediate state to the object and stop transitioning.
413 JSObject::AllocateStorageForMap(json_object, map);
414 int length = properties.length();
415 for (int i = 0; i < length; i++) {
416 Handle<Object> value = properties[i];
417 FieldIndex index = FieldIndex::ForPropertyIndex(*map, i);
418 json_object->FastPropertyAtPut(index, *value);
421 key = ParseJsonInternalizedString();
422 if (key.is_null() || c0_ != ':') return ReportUnexpectedCharacter();
424 AdvanceSkipWhitespace();
425 value = ParseJsonValue();
426 if (value.is_null()) return ReportUnexpectedCharacter();
429 Runtime::DefineObjectProperty(json_object, key, value, NONE).Check();
430 } while (MatchSkipWhiteSpace(','));
432 return ReportUnexpectedCharacter();
435 // If we transitioned until the very end, transition the map now.
437 JSObject::AllocateStorageForMap(json_object, map);
438 int length = properties.length();
439 for (int i = 0; i < length; i++) {
440 Handle<Object> value = properties[i];
441 FieldIndex index = FieldIndex::ForPropertyIndex(*map, i);
442 json_object->FastPropertyAtPut(index, *value);
446 AdvanceSkipWhitespace();
447 return scope.CloseAndEscape(json_object);
450 // Parse a JSON array. Position must be right at '['.
451 template <bool seq_one_byte>
452 Handle<Object> JsonParser<seq_one_byte>::ParseJsonArray() {
453 HandleScope scope(isolate());
454 ZoneList<Handle<Object> > elements(4, zone());
457 AdvanceSkipWhitespace();
460 Handle<Object> element = ParseJsonValue();
461 if (element.is_null()) return ReportUnexpectedCharacter();
462 elements.Add(element, zone());
463 } while (MatchSkipWhiteSpace(','));
465 return ReportUnexpectedCharacter();
468 AdvanceSkipWhitespace();
469 // Allocate a fixed array with all the elements.
470 Handle<FixedArray> fast_elements =
471 factory()->NewFixedArray(elements.length(), pretenure_);
472 for (int i = 0, n = elements.length(); i < n; i++) {
473 fast_elements->set(i, *elements[i]);
475 Handle<Object> json_array = factory()->NewJSArrayWithElements(
476 fast_elements, FAST_ELEMENTS, pretenure_);
477 return scope.CloseAndEscape(json_array);
481 template <bool seq_one_byte>
482 Handle<Object> JsonParser<seq_one_byte>::ParseJsonNumber() {
483 bool negative = false;
484 int beg_pos = position_;
491 // Prefix zero is only allowed if it's the only digit before
492 // a decimal point or exponent.
493 if ('0' <= c0_ && c0_ <= '9') return ReportUnexpectedCharacter();
497 if (c0_ < '1' || c0_ > '9') return ReportUnexpectedCharacter();
499 i = i * 10 + c0_ - '0';
502 } while (c0_ >= '0' && c0_ <= '9');
503 if (c0_ != '.' && c0_ != 'e' && c0_ != 'E' && digits < 10) {
505 return Handle<Smi>(Smi::FromInt((negative ? -i : i)), isolate());
510 if (c0_ < '0' || c0_ > '9') return ReportUnexpectedCharacter();
513 } while (c0_ >= '0' && c0_ <= '9');
515 if (AsciiAlphaToLower(c0_) == 'e') {
517 if (c0_ == '-' || c0_ == '+') Advance();
518 if (c0_ < '0' || c0_ > '9') return ReportUnexpectedCharacter();
521 } while (c0_ >= '0' && c0_ <= '9');
523 int length = position_ - beg_pos;
526 Vector<const uint8_t> chars(seq_source_->GetChars() + beg_pos, length);
527 number = StringToDouble(isolate()->unicode_cache(),
529 NO_FLAGS, // Hex, octal or trailing junk.
530 base::OS::nan_value());
532 Vector<uint8_t> buffer = Vector<uint8_t>::New(length);
533 String::WriteToFlat(*source_, buffer.start(), beg_pos, position_);
534 Vector<const uint8_t> result =
535 Vector<const uint8_t>(buffer.start(), length);
536 number = StringToDouble(isolate()->unicode_cache(),
538 NO_FLAGS, // Hex, octal or trailing junk.
543 return factory()->NewNumber(number, pretenure_);
547 template <typename StringType>
548 inline void SeqStringSet(Handle<StringType> seq_str, int i, uc32 c);
551 inline void SeqStringSet(Handle<SeqTwoByteString> seq_str, int i, uc32 c) {
552 seq_str->SeqTwoByteStringSet(i, c);
556 inline void SeqStringSet(Handle<SeqOneByteString> seq_str, int i, uc32 c) {
557 seq_str->SeqOneByteStringSet(i, c);
560 template <typename StringType>
561 inline Handle<StringType> NewRawString(Factory* factory,
563 PretenureFlag pretenure);
566 inline Handle<SeqTwoByteString> NewRawString(Factory* factory,
568 PretenureFlag pretenure) {
569 return factory->NewRawTwoByteString(length, pretenure).ToHandleChecked();
573 inline Handle<SeqOneByteString> NewRawString(Factory* factory,
575 PretenureFlag pretenure) {
576 return factory->NewRawOneByteString(length, pretenure).ToHandleChecked();
580 // Scans the rest of a JSON string starting from position_ and writes
581 // prefix[start..end] along with the scanned characters into a
582 // sequential string of type StringType.
583 template <bool seq_one_byte>
584 template <typename StringType, typename SinkChar>
585 Handle<String> JsonParser<seq_one_byte>::SlowScanJsonString(
586 Handle<String> prefix, int start, int end) {
587 int count = end - start;
588 int max_length = count + source_length_ - position_;
589 int length = Min(max_length, Max(kInitialSpecialStringLength, 2 * count));
590 Handle<StringType> seq_string =
591 NewRawString<StringType>(factory(), length, pretenure_);
592 // Copy prefix into seq_str.
593 SinkChar* dest = seq_string->GetChars();
594 String::WriteToFlat(*prefix, dest, start, end);
597 // Check for control character (0x00-0x1f) or unterminated string (<0).
598 if (c0_ < 0x20) return Handle<String>::null();
599 if (count >= length) {
600 // We need to create a longer sequential string for the result.
601 return SlowScanJsonString<StringType, SinkChar>(seq_string, 0, count);
604 // If the sink can contain UC16 characters, or source_ contains only
605 // Latin1 characters, there's no need to test whether we can store the
606 // character. Otherwise check whether the UC16 source character can fit
607 // in the Latin1 sink.
608 if (sizeof(SinkChar) == kUC16Size || seq_one_byte ||
609 c0_ <= String::kMaxOneByteCharCode) {
610 SeqStringSet(seq_string, count++, c0_);
613 // StringType is SeqOneByteString and we just read a non-Latin1 char.
614 return SlowScanJsonString<SeqTwoByteString, uc16>(seq_string, 0, count);
617 Advance(); // Advance past the \.
622 SeqStringSet(seq_string, count++, c0_);
625 SeqStringSet(seq_string, count++, '\x08');
628 SeqStringSet(seq_string, count++, '\x0c');
631 SeqStringSet(seq_string, count++, '\x0a');
634 SeqStringSet(seq_string, count++, '\x0d');
637 SeqStringSet(seq_string, count++, '\x09');
641 for (int i = 0; i < 4; i++) {
643 int digit = HexValue(c0_);
645 return Handle<String>::null();
647 value = value * 16 + digit;
649 if (sizeof(SinkChar) == kUC16Size ||
650 value <= String::kMaxOneByteCharCode) {
651 SeqStringSet(seq_string, count++, value);
654 // StringType is SeqOneByteString and we just read a non-Latin1
656 position_ -= 6; // Rewind position_ to \ in \uxxxx.
658 return SlowScanJsonString<SeqTwoByteString, uc16>(seq_string,
664 return Handle<String>::null();
671 // Advance past the last '"'.
672 AdvanceSkipWhitespace();
674 // Shrink seq_string length to count and return.
675 return SeqString::Truncate(seq_string, count);
679 template <bool seq_one_byte>
680 template <bool is_internalized>
681 Handle<String> JsonParser<seq_one_byte>::ScanJsonString() {
685 AdvanceSkipWhitespace();
686 return factory()->empty_string();
689 if (seq_one_byte && is_internalized) {
690 // Fast path for existing internalized strings. If the the string being
691 // parsed is not a known internalized string, contains backslashes or
692 // unexpectedly reaches the end of string, return with an empty handle.
693 uint32_t running_hash = isolate()->heap()->HashSeed();
694 int position = position_;
699 int beg_pos = position_;
700 position_ = position;
701 return SlowScanJsonString<SeqOneByteString, uint8_t>(source_,
705 if (c0 < 0x20) return Handle<String>::null();
706 if (static_cast<uint32_t>(c0) >
707 unibrow::Utf16::kMaxNonSurrogateCharCode) {
709 StringHasher::AddCharacterCore(running_hash,
710 unibrow::Utf16::LeadSurrogate(c0));
712 StringHasher::AddCharacterCore(running_hash,
713 unibrow::Utf16::TrailSurrogate(c0));
715 running_hash = StringHasher::AddCharacterCore(running_hash, c0);
718 if (position >= source_length_) return Handle<String>::null();
719 c0 = seq_source_->SeqOneByteStringGet(position);
721 int length = position - position_;
722 uint32_t hash = (length <= String::kMaxHashCalcLength)
723 ? StringHasher::GetHashCore(running_hash)
724 : static_cast<uint32_t>(length);
725 Vector<const uint8_t> string_vector(
726 seq_source_->GetChars() + position_, length);
727 StringTable* string_table = isolate()->heap()->string_table();
728 uint32_t capacity = string_table->Capacity();
729 uint32_t entry = StringTable::FirstProbe(hash, capacity);
731 Handle<String> result;
733 Object* element = string_table->KeyAt(entry);
734 if (element == isolate()->heap()->undefined_value()) {
736 result = factory()->InternalizeOneByteString(
737 seq_source_, position_, length);
740 if (element != isolate()->heap()->the_hole_value() &&
741 String::cast(element)->IsOneByteEqualTo(string_vector)) {
742 result = Handle<String>(String::cast(element), isolate());
744 uint32_t hash_field =
745 (hash << String::kHashShift) | String::kIsNotArrayIndexMask;
746 DCHECK_EQ(static_cast<int>(result->Hash()),
747 static_cast<int>(hash_field >> String::kHashShift));
751 entry = StringTable::NextProbe(entry, count++, capacity);
753 position_ = position;
754 // Advance past the last '"'.
755 AdvanceSkipWhitespace();
759 int beg_pos = position_;
760 // Fast case for Latin1 only without escape characters.
762 // Check for control character (0x00-0x1f) or unterminated string (<0).
763 if (c0_ < 0x20) return Handle<String>::null();
765 if (seq_one_byte || c0_ <= String::kMaxOneByteCharCode) {
768 return SlowScanJsonString<SeqTwoByteString, uc16>(source_,
773 return SlowScanJsonString<SeqOneByteString, uint8_t>(source_,
777 } while (c0_ != '"');
778 int length = position_ - beg_pos;
779 Handle<String> result =
780 factory()->NewRawOneByteString(length, pretenure_).ToHandleChecked();
781 uint8_t* dest = SeqOneByteString::cast(*result)->GetChars();
782 String::WriteToFlat(*source_, dest, beg_pos, position_);
785 // Advance past the last '"'.
786 AdvanceSkipWhitespace();
790 } } // namespace v8::internal
792 #endif // V8_JSON_PARSER_H_