Changelog History
Page 2
-
v2.0.0 Changes
March 26, 2026Karate 2.0.0
🚀 The first major release of Karate v2 — a ground-up rewrite of the test automation framework, built on Java 21+ virtual threads with a custom JavaScript engine.
Highlights
- Custom JS Engine — embedded JavaScript engine (
karate-js) replaces GraalJS. Minimal external dependencies, faster startup, native Java interop - Virtual Threads — parallel test execution on Java 21+ virtual threads. No thread pool tuning needed
- W3C WebDriver — full cross-browser support for Chrome, Firefox, Safari, and Edge alongside the existing CDP driver
- 💻 Browser Pooling — automatic browser instance reuse across parallel scenarios via
PooledDriverProvider - Karate CLI — single binary launcher, no Maven or Gradle required. Install from VS Code with one click:
- Rewritten CDP Driver — auto-wait, Shadow DOM support, smarter element location
- Gatling Integration — Java-only DSL for load testing (
karateProtocol(),karateFeature()) - Interactive HTML Reports — Alpine.js dashboard with timeline view, tag filtering, and nested call display
- Declarative Auth —
configure authfor Basic, Bearer, and OAuth2 with automatic token refresh - Soft Assertions — All JSON errors collected instead of first assertion failure.
continueOnStepFailuremode for features - Built-in Utilities —
karate.faker.*for test data,karate.expect()for Chai-style assertions
📚 Documentation
- 📄 Migration Guide (v1 → v2)
- 📄 What's New in v2
- 📄 Install & Get Started
- ✅ Browser Automation (CDP + WebDriver)
- 📄 Design Principles
- VS Code Extension
- 🔌 IntelliJ Plugin
- Karate CLI / Universal Installer
💥 Breaking Changes
👀 See the Migration Guide for details.
🚀 Artifacts Released
- Maven artifacts
- 📄 Standalone JAR (download below)
- CVE / SBOM report (download below)
- Custom JS Engine — embedded JavaScript engine (
-
v2.0.0.RC2 Changes
March 24, 2026📄 Refer: v1 to v2 Migration Guide.
-
v1.5.2 Changes
November 30, 2025No Breaking Changes
🚀 This release is mainly to
- ✅ ensure Karate works with the latest Java versions > 21
- ⚡️ update Gatling integration to avoid a warning in reports
- ⬆️ upgrade multiple library / dependencies because of CVEs or common conflicts.
⚡️ Meet the Karate team in Paris on December 11, 2025 ! (Register here)
🛠 Fix List
🚀 Here is a complete list of all issues fixed in this release.
What's Changed
- ✅ #2641 introduce @fail tag to mark tests which are expected to fail by @dve in #2643
- ➕ Add an optional environment variable for docker images in order to easily and globally configure additional startup flags by @abdallahghdiri in #2649
- 👌 Support for Case-Sensitive HTTP Headers in Karate Mock Server by @srmppn in #2653
- ⚡️ [KeepOriginalHeaders] update document by @srmppn in #2656
- #2660 fail annotation in xml report by @dve in #2661
- ⬆️ Upgrade json-smart from 2.5.1 to 2.5.2 fixing CVE-2024-57699 by @julianladisch in #2663
- #2667 result count by @dve in #2668
- Dated version for Karate Gatling integration #2677) Feature/gatling 3.11.5 by @CPogX in #2678
- 🛠 fix #2670 by @ThierryLejeune in #2674
- Issue 2482: accept empty cookies names by @cranberrysoft in #2676
- 💻 Karate UI - javascript error: Unexpected token #2665 xpath parenthesis by @CPogX in #2675
- ➕ Add WebSocket frame aggregation support by @jon-armen in #2693
- 🏁 clarify mvn quickstart command syntax for Windows PowerShell by @markhughes321 in #2695
- 2515 third revision logic in matchoperator by @f-delahaye in #2702
- 2707 by @f-delahaye in #2709
- 🛠 Fix forward slashes being turned into escape by @srmppn in #2714
A Big Thank You
To all contributors, especially first-time contributors to Karate.
🆕 New Contributors
- @dve made their first contribution in #2643
- @abdallahghdiri made their first contribution in #2649
- @srmppn made their first contribution in #2653
- @cranberrysoft made their first contribution in #2676
- @markhughes321 made their first contribution in #2695
Full Changelog : v1.5.1...v1.5.2
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
- Repository SBOM report (download below)
-
v1.5.1 Changes
January 06, 2025No Breaking Changes
🚀 This release is mainly to upgrade a couple of library / dependencies because of CVEs or common conflicts.
- ⬆️ Upgrade netty due to CVE-2024-47535
- ⚡️ Update classgraph to solve Quarkus related ExceptionInInitializerError
🛠 Fix List
🚀 Here is a complete list of all issues fixed in this release.
What's Changed
- 🛠 Fixed readme for karate-gatling by @debasisj in #2608
- ⬆️ Bump commons-io:commons-io from 2.7 to 2.14.0 in /karate-demo by @dependabot in #2614
- ⚡️ Update Chrome DevTools Protocol by @oxsoft in #2590
- ⚡️ Update headless option by @oxsoft in #2592
- ⬆️ Upgrade JaCoCo to 0.8.12 by @Godin in #2635
- 🖐 handle mp4 like any other media in Embed toMap() by @CPogX in #2638
- ➕ Add afterScenarioOutline & karate.scenarioOutline by @OwenK2 in #2636
- 👌 Improve readme by @alaguna95 in #2640
A Big Thank You
To all contributors, especially first-time contributors to Karate.
🆕 New Contributors
- @debasisj made their first contribution in #2608
- @oxsoft made their first contribution in #2590
- @abdallah-rashwan made their first contribution in #2628
- @Godin made their first contribution in #2635
- @CPogX made their first contribution in #2638
- @OwenK2 made their first contribution in #2636
- @alaguna95 made their first contribution in #2640
Full Changelog : v1.5.0...v1.5.1
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
- Repository SBOM report (download below)
-
v1.5.0 Changes
August 05, 2024💥 Breaking Changes
- Karate 1.5.0 requires Java 17
- The Maven group-id has changed from
com.intuit.karatetoio.karatelabs
🏗 So the only change should be to your
pom.xmlorgradle.build.There are no other syntax or behavior breaking changes, so this should be a smooth upgrade for your tests. The Java APIs (package names) have not changed. They will change only in a future release (most likely 1.6.0).
Notable Improvements
🛠 Fix List
🚀 Here is a complete list of all issues fixed in this release.
Full Changelog : v1.4.1...v1.5.0
A Big Thank You
To all contributors, especially first-time contributors to Karate.
👀 And to all our users and community. We are proud to see Karate cross the 8000 star mark on GitHub 🚀 ⭐ 🙏
🆕 New Contributors
- @fabio-andre-rodrigues made their first contribution in #2402
- @san70sh made their first contribution in #2420
- @f-delahaye made their first contribution in #2421
- @Songshen1996 made their first contribution in #2428
- @ciandt-crodrigues made their first contribution in #2440
- @sergy8612 made their first contribution in #2445
- @bouncysteve made their first contribution in #2452
- @codehackerr made their first contribution in #2477
- @AKushWarrior made their first contribution in #2505
- @dustinsand made their first contribution in #2532
- @brown-kaew made their first contribution in #2535
- @SirJerric made their first contribution in #2555
- @jandry made their first contribution in #2424
- @daviddavidgit made their first contribution in #2573
- @xloypaypa made their first contribution in #2570
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
- Repository SBOM report (download below)
-
v1.5.0.RC5 Changes
July 26, 2024🚀 Karate 1.5.0 will require Java 17. Karate 1.5.0 will also change the Maven group-id from
com.intuit.karatetoio.karatelabs. For a smoother transition, the Java APIs would be changed in a future release (most likely 1.6.0). Karate 1.5.0 is required if you use Java 22 or greater.🚀 This is an RC release, so there could be minor changes before 1.5.0 (final). But most teams can start using this, especially those who need Java 17 and the CVE resolutions.
Notable Improvements
🛠 Fix List
🚀 Here is a complete list of all issues fixed in this release.
Full Changelog : v1.4.1...v1.5.0.RC5
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
- Repository SBOM report (download below)
-
v1.5.0.RC3 Changes
February 01, 2024🚀 Karate 1.5.0 will require Java 17. Karate 1.5.0 will also change the Maven group-id from
com.intuit.karatetoio.karatelabs. For a smoother transition, the Java APIs would be changed in a future release (most likely 1.6.0).🚀 This is an RC release, so there could be minor changes before 1.5.0 (final). But most teams can start using this, especially those who need Java 17 and the CVE resolutions.
Notable Improvements
🛠 Fix List
🚀 Here is a complete list of all issues fixed in this release. Since the statuses can change, use the below snapshot as a reference.
Full Changelog : v1.4.1...v1.5.0.RC3
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
- Repository SBOM report (download below)
-
v1.4.1 Changes
October 16, 2023🆕 First, a big THANK YOU to all new contributors !
🆕 New Contributors
- @kang-mansher made their first contribution in #2315
- @MohabMohie made their first contribution in #2318
- @lucarota made their first contribution in #2325
- @dvargas46 made their first contribution in #2343
- @barathraju-43 made their first contribution in #2354
- @dersvenhesse made their first contribution in #2368
- @dovikos made their first contribution in #2370
- @byd-android-2017 made their first contribution in #2375
- @GeorgeLBS1 made their first contribution in #2376
- @tstanczak made their first contribution in #2392
- @luanapassis made their first contribution in #2400
- @ksola made their first contribution in #2409
- @bharath2203 made their first contribution in #2415
For those interested in participating in Hacktoberfest, you can find instructions here: Karate and Hacktoberfest
🛠 Fix List
Some notable improvements:
- 👀 UI testing -
driver.intercept()(Chrome only) now returns a mock, which opens up some advanced use-cases, see #2361 - 👀 some teams reported a slow down in Karate 1.4.0 especially when a lot of JS re-use was involved, which should be fixed, see #2329
🚀 Here is a complete list of all issues fixed in this release.
💥 Breaking Changes
✅ The good news is that for most teams there should not be any breakages to existing test scripts. But there are a few things to note, read on below.
0️⃣
match eachdefaults to fail if array is empty👀 You can read a detailed description in the issue #2364. This may break existing test scripts only if you are extensively using the fuzzy matching short-cut
#[]in enbedded schema validations. The good news is that if you see any of your existing tests break, you can do this to get back the old behavior.\* configure matchEachEmptyAllowed = trueif a
match eachfails now with Karate 1.4.1, ensure that any JsonPath expression on the LHS (Left Hand Side) is accurate. The reason for this change in Karate behavior is that previously - if you had an invalid JsonPath expression on the LHS of amatch each, it would always return an empty array, and thematchwould always pass.🐳 Docker image now in
karatelabsorganization🐳 Until now, the karate-chrome Docker image was published at ptrthomas/karate-chrome. It has now moved to karatelabs/karate-chrome.
IDE debugging requires extra dependency
IDE debugging now requires an extra dependency on the classpath. Maven and Gradle users can use the
io.karatelabs:karate-debugserverdependency. For details on how to use the new debug-server in IntelliJ or VS Code, please refer to this wiki page: Debug Server.🚚 Experimental Distributed Testing Support Removed
🚀 Karate used to have a distributed-testing (experimental) option released in v0.9.5. This is no-longer available as part of karate-core
Heads Up
🚀 Karate 1.5.0 will require Java 17. This is a bit sooner than we expected, but reasons are explained in #2401 - mainly because of needing to address some CVEs. 1.4.1 may be the last release that supports Java 11.
🚀 Karate 1.5.0 will also change the Maven group-id from
com.intuit.karatetoio.karatelabs. Note that a 1.5.0.RC1 is available for teams to start trying this out. For a smoother transition, the Java APIs would be changed in a future release (most likely 1.6.0).What's Changed
- ⚡️ update java versions to 11 since 1.8 no longer supported by @ericdriggs in #2307
- ➕ Added changes for self signed cert generation by @kang-mansher in #2315
- ⚡️ Update Demo01JavaRunner.java by @MohabMohie in #2318
- ⚡️ Update README.md by @bischoffdev in #2323
- 🛠 Fix #2324 - karate.callSingle caching fails on Windows using different keys by @lucarota in #2325
- 🛠 fix retry with setup by @jkeys089 in #2335
- ➕ add support for NTLM authentication by @dvargas46 in #2343
- ⬆️ Bump docker/login-action from 2.1.0 to 2.2.0 by @dependabot in #2339
- 🛠 fixed mouse(x, y) to accept Number type by @barathraju-43 in #2354
- ⬆️ Bump docker/login-action from 2.1.0 to 2.2.0 by @dependabot in #2355
- ⬆️ Bump h2 from 2.1.210 to 2.2.220 in /karate-demo by @dependabot in #2359
- ⬆️ Bump docker/login-action from 2.1.0 to 2.2.0 by @dependabot in #2360
- ⬆️ Bump com.linecorp.armeria:armeria from 1.22.0 to 1.24.3 in /karate-core by @dependabot in #2369
- chore: use fragment expression by @dersvenhesse in #2368
- 👉 Use Netty HttpPostRequestEncoder with "HTML5" encoder mode to prevent… by @dovikos in #2370
- ⚡️ chore: use updated thymeleaf syntax by @dersvenhesse in #2372
- ⚡️ Update README.md by @byd-android-2017 in #2375
- 🛠 Fix: Resolves #2259 doubleClick and rightClick issue by @GeorgeLBS1 in #2376
- ⬆️ Bump actions/checkout from 3 to 4 by @dependabot in #2391
- Http using RuntimeHook by @tstanczak in #2392
- ⬆️ Bump docker/login-action from 2.2.0 to 3.0.0 by @dependabot in #2395
- 👻 retry on invoke exception by @ericdriggs in #2397
- Description by @luanapassis in #2400
- 0️⃣ 2408 Allow retries to be enabled on default Apache HTTP client by @ksola in #2409
- 🛠 Fix: XML whitespace trims while pretty print by @bharath2203 in #2415
Full Changelog : v1.4.0...v1.4.1
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
-
v1.4.0 Changes
April 02, 2023Important
⬆️ There are multiple security vulnerabilities in libraries that Karate depends on that are fixed in this release. If you are on an old version of Karate - it is strongly recommended that you upgrade. Refer #2148 | #2265 | #2277
💥 Breaking Changes
The main change in this release is that Karate requires Java 11 or above. We no longer support Java 8. Otherwise there should not be any syntax or behavior changes (from Karate 1.3.X).
Note that some of the security / CVE fixes cannot be back-ported to Java 8 because they depend on Java 11.
Also note:
- 🚚 JUnit 4 is no longer supported. If you were using JUnit 4, either move to the
RunnerAPI or JUnit 5 - 🚀 The ZIP release is no longer published since the official Karate plugins provide a better quick-start experience. The stand-alone JAR is still available.
- 🤡 The
karate-mock-servletdependency is no longer published - The old
cucumber-java1.2.5 dependency is no longer included, refer #2214
🛠 Fix List
🚀 Here is a complete list of all issues fixed in this release.
What's Changed
- 🛠 fix bug preventing 'Transparent' button from updating image diff UI by @jkeys089 in #2173
- ⬆️ Bump actions/cache from 2 to 3 by @dependabot in #2179
- ⚡️ update image-comparison example by @jkeys089 in #2185
- Enable each contains deep functionality by @vincent-hennig in #2190
- 👌 improve HTML report loading performance by @jkeys089 in #2194
- Develop by @ThierryLejeune in #2199
- 👌 improve Result details for http failure by @shrik18 in #2219
- Clarify path example with trailing slash by @felipecrs in #2246
- ⬆️ Upgrade snakeyaml from 1.33 to 2.0 fixing CVE-2022-1471 by @julianladisch in #2266
- ➕ add check if contextClassLoader is null #2287 by @ajaravete in #2288
🆕 New Contributors
- @vincent-hennig made their first contribution in #2190
- @shrik18 made their first contribution in #2219
- @felipecrs made their first contribution in #2246
- @ajaravete made their first contribution in #2288
Full Changelog : v1.3.1...v1.4.0
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
- 🚚 JUnit 4 is no longer supported. If you were using JUnit 4, either move to the
-
v1.3.1 Changes
December 07, 2022🚀 This is a bug-fix release.
🚀 Please refer to the release notes of v1.3.0 if you are upgrading from an older version.
- Karate HTML report slow for large features #1270
- 🆕 New
@setupwrongly increased scenario count #2169 - 🆕 New
@setupwas running even when supposed to be skipped #2169 - 🆕 New
@setupmissed a way to run setup once #2210 - One more JS multi-threaded error solved #2204
- HTML report now includes
karate.env#2196 - 👍 Better support for file-upload when files is an array #2171
match eachnow works forcontains deep#2170
🚀 Artifacts Released
- Maven artifacts
- Standalone JAR (download below)
- 🚀 ZIP Release (download below)
- 🏁 Karate-Robot JAR (download below)
- 🐳 Docker Image
