Skip to content

Latest commit

 

History

History
280 lines (188 loc) · 13.7 KB

README.md

File metadata and controls

280 lines (188 loc) · 13.7 KB


VS Code
Extension

PLUS PRO Enterprise
    (includes all in PLUS)     [*] coming soon

By using this plugin, you agree to the Karate Labs EULA. Data on a few user actions is collected and subject to our Privacy Policy. HTML reports generated by the Karate open-source library has additional analytics.

License Activation

License activation and status is available via a command. Go to View -> Command Palette, type Karate and you should see something like this.

 

Choose the option to Sign In / Manage License and you will be shown a dialog. Click Sign In to be taken through the usual flow linked to your existing subscription details.

Once you have authenticated successfully, copy the session ID from the browser and paste it into the input-box now showing in VS Code. Hit ENTER to complete the sign-in.

 

Once signed-in you can work offline. You can always run the Sign In / Manage License command to see how many days are left in your session.

If you need an offline license because of strict security or similar restrictions in your environment, please contact us. Please note that this option is available only for enterprise customers of Karate Labs.

Settings

You can access the extension settings by clicking on the "gear" icon after going to "Extensions" on the nav-bar.

 

Especially if you are working with Java Maven or Gradle projects, it is recommended that you have the Language Support for Java VS Code extension installed.

Then keep the karatelabs.karate.run.mode setting as vscode-java (the default).

Standalone

You can change the karatelabs.karate.run.mode setting to standalone if you want to use the Karate standalone JAR. Download it and choose a local folder to keep JAR files in. Change the karatelabs.karate.run.modeJars setting to point to that folder, and for convenience, all JARs within that folder will be included in the runtime classpath.

Note that the Mode Jars setting should be a folder name. Do not include the .jar part. Note that the default of . will work fine for the common practice of keeping the Karate JAR in the "root" of your project folder.

The karatelabs.karate.run.classpathPrefix setting defaults to . which should suffice for picking up karate-config.js from the workspace root. You can add more classpath entries (comma-delimited) and even JAR files if you wish. For example .,src/test/java would also search in src/test/java for karate-config.js.

Note that VS Code has a mechanism to customize settings per Workspace (or project folder) which can ensure your whole team uses the same settings. Here is an example of how the values of the run.mode and classpathPrefix can be written to a file in .vscode/settings.json. Now this file can be added to your Git repository or version control.

Custom

You can also opt to run commands such as java or mvn directly with karatelabs.karate.run.mode set to custom. In this case java or mvn is expected to be installed and in the system PATH.

For convenience the string ${karateArgs} will be replaced with command-line arguments generated by the extension when performing actions such as Run etc.

Troubleshooting

If the Language Support for Java extension is not installed, you will need a Java runtime installed and JAVA_HOME set in your environment. Having the java command in your system PATH should also be sufficient. Java 11 or higher is needed for Karate 1.4.X and Java 17 is needed for Karate 1.5.0 and above.

There is a Karate Log within the "Output" tab (next to "Terminal") typically at the bottom of your VS Code window. You can look at it to find the reasons for failure.

 

To change the log level you can use the VS Code Command Developer: Set Log Level (View --> Command Palette and type "Log") and then select Karate Log. Changing the log level to Debug gives you more information.

Run From Editor

You can run a feature file open in the editor by using the CodeLens. The keyboard shortcut [CTRL] [F5] also works.

 

You can run a single Scenario by using the CodeLens that appears above it.

You can even run a single "example" in a Scenario Outline by right-clicking on one of the data-rows within an Examples table.

Launch Configurations

VS Code launch-configurations are useful for being able to re-run tests with specific parameters. All the typical Karate options you need are supported, including control over the JVM parameters and working directory. The feature file (or path to search for feature files) should be the last argument.

Here is an example .vscode/launch.json file:

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "karate",
            "name": "env-test",
            "request": "launch",
            "karateArgs": [
                "-e",
                "test",
                "${file}"
            ]
        }
    ]
}

The advantage is that you can set up any combination of Karate runtime options via karateArgs. For example you can:

Now you can run tests from the Run and Debug view in VS Code and keyboard short-cuts such as F5 will work for the currently focused file in the editor. Note that you can even Run without Debugging: Ctrl + F5.

 

You can have multiple configurations and easily switch between them.

You can add "noDebug": true to the run-configuration JSON to force "Run without Debugging" for convenience.

Instead of ${file} as the value for feature, you can use any valid folder path or even multiple feature files.

Outline View

The VS Code outline view is supported so you can navigate large files with ease.

Code Formatting

VS Code code-formatting shortcuts work to format indenting of feature file elements.

Test Results

The HTML report is one-click away.

Auto Complete

Besides the syntax validation, you have auto-complete for the most commonly used keywords.

Code Folding

You can collapse sections to make it easier to deal with long tests.

References

Coming Soon.

JSON Re-formatting

Place the cursor within JSON to see options to re-format it, you will see a "bulb" icon.

 

The following options are possible (depending on context):

  • Lenient - just like JS, where single-quotes are used and no quotes are needed for property keys
  • Strict - Strict JSON, using double-quotes
  • Make single Line - convert multi-line JSON to a single line
  • Make multi-line - convert a single line of JSON to multi-line, including triple-quotes

Run Folder

As a convenience, you can right-click and run a folder from the explorer view.

Debug

You can set break-points on Karate feature files in debug mode. The Karate debugger can even step-back and hot-reload simple edits to your test.

Debug Java from Karate

A Karate debug session will even stop at Java breakpoints.

Debug Karate from Java

You can also start a normal Java debug session that uses the Karate Runner Java API but still stop at Karate breakpoints. This requires you to be using Karate version 1.5.0.RC3 or greater.

Offline License

Important

The Offline License is a paid feature for enterprises. Please make sure you know who your designated admin is before you perform this step.

The dialog you see when you invoke the Sign In / Manage License command looks like this.

 

Click the Offline License button. A unique code for your system will be shown which you can cut and paste. In the example below, it is: DhHOFKHvd7XYTi+rQnNTJQ==

 

Send that unique code to your designated admin. You will be issued a license that is tied to this unique code. To apply the license, copy all the text from the license file (which should start with: -----BEGIN LICENSE FILE-----) and paste it into the text-field shown above. Make sure you clear the text-box before pasting the license file text or just replace the initial contents. Now you should see something like this.

 

Click [ENTER] and should see a confirmation message with your license details.