[go] encoding/json/v2: allow streaming JSON methods to return errors.ErrUnsupported

0 views

Skip to first unread message

Joseph Tsai (Gerrit)

unread,

Feb 13, 2026, 7:33:15 PMFeb 13

to goph...@pubsubhelper.golang.org, golang-...@googlegroups.com, Junyang Shao, Damien Neil, Johan Brandhorst-Satzkorn, Go LUCI, Daniel Martí, Michael Pratt, golang-co...@googlegroups.com

Joseph Tsai submitted the change

Change information

Commit message:

encoding/json/v2: allow streaming JSON methods to return errors.ErrUnsupported

Allow the MarshalJSONTo and UnmarshalJSONFrom methods
to return errors.ErrUnsupported to be skipped in a similar manner
to how the caller-specified functions can be skipped as well.

Note that the v1 MarshalJSON and UnmarshalJSON methods may not
return errors.ErrUnsupported as that would be a breaking change.
Also, we couldn't implement it for UnmarshalJSON since
that requires consuming the value, which changes the state of
the underlying jsontext.Decoder.

A side-effect of this change is that MarshalJSONTo and UnmarshalJSONFrom
methods may now return sentinel errors. We document that users
should avoid calling this methods directly and instead
rely on MarshalEncode and UnmarshalDecode,
which can handle the ErrUnsupported sentinel error and
others that we may add in the future.

Fixes #74324
Fixes #76712