Published 2026-10-18 UTC to Maven Central and GitHub. See the publication verification. This minor release reduces unnecessary JavaScript letter escaping while preserving recognized HTML-token protection across trusted fragments. It introduces no new encoder security fix.
forJavaScriptandforJavaScriptBlockleave interior script-name letters readable. The last input character remains escaped if it is C, I, P, R, S, or T in either case. Punctuation and whitespace escapes remain.- HTML does not remove whitespace inside tag names. Escaping
<in a complete string addresses the HTML tag delimiter concern, but cannot protect fragments whose trusted prefix supplies<. The retained terminal escape protects that supported composition case. EncodedWriter.flush()safely emits a pending script letter or high surrogate in general/block JavaScript modes. Flush before writing directly to its wrapped writer; prefer the complete-value Writer facade for a value followed by trusted output. Ordinary chunking matches whole-value output. Flushes can add escapes while preserving the JavaScript UTF-16 value.
| Input | 1.5.1 general/block output | 1.6.0 general/block output |
|---|---|---|
http://google.com |
h\x74\x74\x70:\/\/google.\x63om |
http:\/\/google.com |
script |
\x73\x63\x72\x69\x70\x74 |
scrip\x74 |
i |
\x69 |
\x69 |
cat |
\x63a\x74 |
ca\x74 |
The final-letter rule is conservative, not minimal: csript becomes
csrip\x74 even though it is not a script tag name. Source and attribute-only
modes are unchanged. The guarantee concerns recognized HTML tokens, rather than
every literal </script substring; longer names such as </scripture> are
harmless to the HTML script tokenizer. Existing context and insertion-boundary
requirements still apply, including empty-input and unsafe-template exclusions.
Encoded bytes, snapshots, signatures and cache keys can change. Low-level
Encoder.encode callers must preserve unread input after UNDERFLOW and supply
more input or mark end-of-input, now including a retained ASCII letter.
See the migration record.
Java 8 remains the minimum runtime. Public APIs, null handling, JavaScript string values, runtime dependencies, Maven identities, module/bundle identities and servlet namespaces are unchanged. Core has no runtime dependencies. Keep core and adapter versions aligned; do not combine javax and Jakarta adapters on one classpath or module path.
The 1.5.0 security fixes remain in effect. Applications on older versions should follow that release's migration guidance and security advisory.
Published group org.owasp.encoder, version 1.6.0: encoder, encoder-jsp,
encoder-jakarta-jsp, and parent encoder-parent. The optional test WAR is not
published. encoder-esapi remains retired after 1.4.1 and is not included.
All published artifacts and signatures matched the retained release byte for byte.
The reference toolchain is Eclipse Temurin 17.0.20.1+1, committed Maven
3.10.0, and macOS arm64 with the UTC locale/timezone settings in
RELEASING.md. The reviewed source timestamp is
2026-10-18T17:27:13Z.
The project signing identity is OWASP Java Encoder Release, full primary
fingerprint 1C5F632B86809F2F5DB25092BEA0075F94074A9B. Verify original detached
signatures and signed checksum manifests using KEYS and
VERIFYING.md. Release acceptance requires the exact committed
sources, clean-cache builds, packaged consumers, Docker/browser/WAR tests,
reproducible unsigned payload comparison, all required CI/security checks,
signature verification and comparison of published bytes with retained artifacts.
The publication record records those passed gates
and the exact source, tag, bundle and downloaded-file identities.
The complete open-issue/PR inventory was empty on 2026-10-18 at 17:27 UTC,
after #247 merged as 300ef20c1bfff8c3d4c68216d68f3fe742b0a559 and #243 closed.
The publication record confirms the final pre-publication inventory.
Model-assisted review followed MODELS.md. Astra coordinated
resolution; Sol 6.1, Opus 5.5, Mythos 5.1 and Sonnet 5.5 recommended merging
the final implementation/documentation revision
da8b7a0d298c952aee9064f67dec75e0ab16a32f. Claude Code 2.1.302 response metadata
confirmed claude-opus-5-5, claude-mythos-5-1, and claude-sonnet-5-5.
Codex agent slots requested gpt-6-astra and gpt-6.1-sol; the agent interface
did not independently attest their runtime identities. No Daybreak review was
completed before release; see the dated correction below. AI review is not independent
maintainer approval. Jim Manico explicitly authorized the existing audit-visible
PR-only review bypass for #247; all required CI/security gates passed.
Correction — 2026-10-18: The original review record described Daybreak access as unavailable, but the explicit picker-route probe had not been attempted. A subsequent probe succeeded, as recorded in MODELS.md and PR #251. This establishes later access, not a pre-release review. The release tag and signed artifacts retain their original bytes.
On that revision, the local clean reactor, 36 repository tests, 17 compatibility tests and Java 17 packaged consumers passed. The unchanged implementation passed 12 Chrome tests, and 36 focused Chrome 155 cases checked the latest issue comment. Final CI included packaged Java 8/11/17/21/25 consumers, Java 8 tests and the Docker/browser/WAR fixture. These results do not replace the release-commit gates.
A nonblocking streaming cost remains: a long run of script letters after a pending letter takes the leftover-buffer path repeatedly. One local 1 MiB probe measured about 4.3 times the direct-write time, with linear work and bounded buffer memory. No general performance improvement or cross-browser equivalence is claimed.