Feature: formating of errormessages for display to end user

[cork]

I'm trying to figure out how jsonschema.ValidationError are to be translated to something understandable to an end user, or for that matter looped to for example mark input fields for the error.

I get string like "additioalProperties 'test1', 'test2', 'test3' is not allowed" or "missing properties: 'firstName'". and no separate field to check the list of the fields with the error or what a machine understandable version of the error is.

Am I missing something or isn't there a way to do anything except showing the result as a string blob?

[hbagdi]

I'm trying to do something similar.
In my case, I'd like to introspect the error and get a reference to the Schema node so that I can populate a helpful error for the end user.

So when I get something like:

[I#] [S#] doesn't validate with file:///tmp/schema.json#
  [I#/connect_timeout] [S#/properties/connect_timeout/minimum] must be >= 1 but found -1
  [I#] [S#/allOf/0] allOf failed
    [I#] [S#/allOf/0/then] if-then failed
      [I#/protocol] [S#/allOf/0/then/properties/protocol/const] value must be "https"

I ultimately want to access the "title" or "description" field of the if or else and return that to the user.

Is there a way to fetch the Schema based on the KeywordLocation of an error?

[santhosh-tekuri]

@cork api to access values from error message could be potential feature, may be for next release

@hbagdi you can navigate *Schema using KeywordLocation as if it is simple xpath. but this might be tricky if the schema uses $dynamicRef

[hbagdi]

@hbagdi you can navigate *Schema using KeywordLocation as if it is simple xpath. but this might be tricky if the schema uses $dynamicRef

Are there any tools or helper functions to do this? I looked into the code but didn't find anything close.

I see you've https://github.com/santhosh-tekuri/xpath but I don't have a remote idea on how that can parse a JSON Schema. Any pointers to dig deeper?

[santhosh-tekuri]

sorry. not xpath. as jsonpath
for example consider keywordLocation /allOf/0/then/properties/protocol/const

you split it by / and for each part navigate struct

so golang navigation for keywordLocation /allOf/0/then/properties/protocol/const is

schema.AllOf[0].Then.Properties["protocol"].Const

[santhosh-tekuri]

you can find some sample code here

the sample code works on json objects like map/interface.

in your case you have to do it for *Schema struct

[hbagdi]

@santhosh-tekuri Thank you for your response here. Your commentary was very helpful for me to arrive at a solution.

[Surfoo]

Hello @santhosh-tekuri,

What do you think to implement only one string per error and custom error with templating like https://github.com/xeipuuv/gojsonschema? (This lib seems unmaintened...) It will be a great feature 👍

[TeCHiScy]

api to access values from error message could be potential feature, may be for next release

hi @santhosh-tekuri, thanks for your great work first. I'd like to vote on the api, with an api to get the keywordPath and the args in the validationError, it will be very easy for developers to format validation errors into what they want.

[Oct17th]

hi @santhosh-tekuri，I have a similar situation here，I hope there has a interface that i can define custom error template，did you have plan to support it？

[santhosh-tekuri]

Started working on this feature. Will post pull request tomarrow

[santhosh-tekuri]

please check pull request #99
this pull request changes type of ValidationError.Message from string to struct implementing fmt.Stringer

go through the changes and let me know your opinion