CodeSampleX

Sample

encoding/json go1.26.5: Show that `omitzero` now changes omission semantics from zero-value checks to `IsZero()`-based suppression.

Verified sample for golang encoding/json go1.26.5: Show that `omitzero` now changes omission semantics from zero-value checks to `IsZero()`-based…

sha256:eb57efa77cb0674636a1673e4b19f20da371c0f52c90951ffb32d39e42e874bc

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment go linux x64 go go go

Verification-run environments

Environment Contract Stages Run
go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-16
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18

Case

HOW
Goal
Show that `omitzero` now changes omission semantics from zero-value checks to `IsZero()`-based suppression.
Packages
Symbols
  • encoding/json.Marshal
  • encoding/json
Environment
go
Created
2026-08-16T13:04:28Z

Contract

  1. assert json.Marshal with tag `field,omitzero` omits a non-empty struct when its IsZero() method returns true
  2. assert json.Marshal with tag `field,omitempty` keeps that same non-empty struct value

Files

  • NOTES.md
  • csx.json
  • go.mod
  • json_v2_strict_test.go

Download the source artifact (tar.gz)

Source

NOTES.md
# notes
search_known_solution returned no direct encoding/json hit for this specific `omitzero` boundary, so no existing sample was reused for this case.
Wrong legacy behavior fails silently with a green build: in code using only `omitempty`, a field whose `IsZero()` returns true but is not reflect-empty still serializes, while `encoding/json` with `,omitzero` now omits it.
csx.json
{"case":{"believed":"A field is omitted only when its value is reflect-empty, so a non-empty struct value must always be serialized unless `omitempty` is false.","caseId":"case:sha256:6dcd24cf18d3e94024d209c7cfee593f71c25faeb9b7fba9d23f471db3adc444","contract":["assert json.Marshal with tag `field,omitzero` omits a non-empty struct when its IsZero() method returns true","assert json.Marshal with tag `field,omitempty` keeps that same non-empty struct value"],"goal":"Show that `omitzero` now changes omission semantics from zero-value checks to `IsZero()`-based suppression.","kind":"HOW","packages":["pkg:golang/encoding/json@go1.26.5"],"schemaVersion":1,"symbols":["encoding/json.Marshal","encoding/json"]},"contractCommand":["go","test","./..."],"environment":{"arch":"x64","ecosystem":"golang","executionContext":"go","language":"go","os":"linux","packageManager":"go","runtime":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/encoding/json@go1.26.5"],"schemaVersion":1,"symbols":["encoding/json.Marshal","encoding/json"],"verifierAdapter":"golang@1"}
go.mod
module example.com/json-jsonv2-contract

go 1.26
json_v2_strict_test.go
package jsoncompat

import (
    "encoding/json"
    "strings"
    "testing"
)

type isZeroByRule struct {
    N int
}

func (v isZeroByRule) IsZero() bool {
    return v.N == 42
}

type withOmitZero struct {
    Field isZeroByRule `json:"field,omitzero"`
}

type withOmitEmpty struct {
    Field isZeroByRule `json:"field,omitempty"`
}

func TestOmitZeroHonorsTypeIsZero(t *testing.T) {
    payload, err := json.Marshal(withOmitZero{Field: isZeroByRule{N: 42}})
    if err != nil {
        t.Fatalf("Marshal error: %v", err)
    }
    if got, want := strings.TrimSpace(string(payload)), "{}"; got != want {
        t.Fatalf("got %s, want %s", got, want)
    }
}

func TestOmitEmptyStillIncludesNonEmptyStruct(t *testing.T) {
    payload, err := json.Marshal(withOmitEmpty{Field: isZeroByRule{N: 42}})
    if err != nil {
        t.Fatalf("Marshal error: %v", err)
    }
    want := `{"field":{"N":42}}`
    if got := strings.TrimSpace(string(payload)); got != want {
        t.Fatalf("got %s, want %s", got, want)
    }
}

Origin Seeder

csx-seed