@zhigang1992 I believe you added this in #406 to parse json strings as opposed to initialize with a string value like JSON("hello") which does accept invalid json strings. Since JSON.parse is undocumented already, how would you feel about having init(jsonString: String) throws instead? It would avoid the init(object: ) confusion by making it clear you need a valid json string there. We would also throw if the data is invalid. Let me know.

@ldiqual I think that's a good idea, we should document the crap out of it this time. 😄