Add Scenario.getLanguage() (#3124)

Author: antagoony

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 ### Added
 - [Core] Upload Cucumber Reports with Gzip encoding ([#3115](https://github.com/cucumber/cucumber-jvm/pull/3115))
+- [Java] Add a getter to `Scenario` to return the current language ([cucumber/cucumber-expressions#376](https://github.com/cucumber/cucumber-expressions/issues/376) Stefan Gasterstädt)
 
 ## [7.32.0] - 2025-11-21
 ### Changed

cucumber-core/src/main/java/io/cucumber/core/backend/TestCaseState.java

@@ -84,6 +84,11 @@ public interface TestCaseState {
      */
     URI getUri();
 
+    /**
+     * @return the language of the Scenario.
+     */
+    String getLanguage();
+
     /**
      * @return the line in the feature file of the Scenario. If this is a
      *         Scenario from Scenario Outlines this will return the line of the

cucumber-core/src/main/java/io/cucumber/core/runner/TestCase.java

@@ -130,6 +130,11 @@ private String fileColonLine(Integer line) {
         return pickle.getUri().getSchemeSpecificPart() + ":" + line;
     }
 
+    @Override
+    public String getLanguage() {
+        return pickle.getLanguage();
+    }
+
     @Override
     public List<String> getTags() {
         return pickle.getTags();

cucumber-core/src/main/java/io/cucumber/core/runner/TestCaseState.java

@@ -145,6 +145,11 @@ public URI getUri() {
         return testCase.getUri();
     }
 
+    @Override
+    public String getLanguage() {
+        return testCase.getLanguage();
+    }
+
     @Override
     public Integer getLine() {
         return testCase.getLocation().getLine();

cucumber-core/src/test/java/io/cucumber/core/runner/TestCaseStateTest.java

@@ -36,6 +36,27 @@ void provides_the_uri_of_the_feature_file() {
         assertThat(state.getUri(), is(new File("path/file.feature").toURI()));
     }
 
+    @Test
+    void provides_the_language_of_the_feature_file_without_language_declaration() {
+        Feature feature = TestFeatureParser.parse("file:path/file.feature", "" +
+                "Feature: Test feature\n" +
+                "  Scenario: Test scenario\n" +
+                "     Given I have 4 cukes in my belly\n");
+        TestCaseState state = createTestCaseState(feature);
+        assertThat(state.getLanguage(), is("en"));
+    }
+
+    @Test
+    void provides_the_language_of_the_feature_file_with_language_declaration() {
+        Feature feature = TestFeatureParser.parse("file:path/file.feature", "" +
+                "#language: en\n" +
+                "Feature: Test feature\n" +
+                "  Scenario: Test scenario\n" +
+                "     Given I have 4 cukes in my belly\n");
+        TestCaseState state = createTestCaseState(feature);
+        assertThat(state.getLanguage(), is("en"));
+    }
+
     private TestCaseState createTestCaseState(Feature feature) {
         return new TestCaseState(bus,
             UUID.randomUUID(),

cucumber-java/src/main/java/io/cucumber/java/Scenario.java

@@ -130,6 +130,13 @@ public URI getUri() {
         return delegate.getUri();
     }
 
+    /**
+     * @return the language of the Scenario.
+     */
+    public String getLanguage() {
+        return delegate.getLanguage();
+    }
+
     /**
      * Returns the line in the feature file of the Scenario.
      * <p>

cucumber-junit-platform-engine/src/test/java/io/cucumber/junit/platform/engine/TestCaseResultObserverTest.java

@@ -67,6 +67,11 @@ public String getScenarioDesignation() {
             return "mock-test-case:12";
         }
 
+        @Override
+        public String getLanguage() {
+            return "en";
+        }
+
         @Override
         public List<String> getTags() {
             return emptyList();

cucumber-plugin/src/main/java/io/cucumber/plugin/event/TestCase.java

@@ -38,6 +38,8 @@ public interface TestCase {
     @Deprecated
     String getScenarioDesignation();
 
+    String getLanguage();
+
     List<String> getTags();
 
     List<TestStep> getTestSteps();