# template generate lightning test

Generate a Lightning test.

## Description for template generate lightning test

Generates the test in the specified directory or the current working directory. The .resource file and associated metadata file are generated.

## Aliases for template generate lightning test

`force:lightning:test:create`

`lightning:generate:test`

## Flags

| Flag Name (Long) | Flag Name (Short) | Description                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--api-version`  | N/A               | **Type:** Value<br><br>Override the api version used for api requests made by this command                                                                                                                                                                                                                                                                                                                                                         |
| `--flags-dir`    | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                                                                                                                                                                                                                                                                                                                        |
| `--json`         | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                                                                                                                                                                                                                                                                                                                    |
| `--name`         | `-n`              | **Type:** Value<br>**Required**<br><br>Name of the generated Lightning Test.<br><br>Name of the new Lightning test; can be up to 40 characters and must start with a letter.                                                                                                                                                                                                                                                                       |
| `--output-dir`   | `-d`              | **Type:** Value<br>**Default value:** `.`<br><br>Directory for saving the created files.<br><br>The location can be an absolute path or relative to the current working directory. The default is the current directory.                                                                                                                                                                                                                           |
| `--template`     | `-t`              | **Type:** Value<br>**Valid Values:** `DefaultLightningTest`<br>**Default value:** `DefaultLightningTest`<br><br>Template to use for file creation.<br><br>Supplied parameter values or default values are filled into a copy of the template. For Lightning Web Components, if this flag isn't specified, the CLI command automatically selects the template based on the "defaultLwcLanguage" field in the DX project's "sfdx-project.json" file. |

## Examples for template generate lightning test

Generate the metadata files for the Lightning test called MyLightningTest in the current directory:

```shell
sf template generate lightning test --name MyLightningTest
```

Similar to the previous example but generate the files in the "force-app/main/default/lightningTests" directory:

```shell
sf template generate lightning test --name MyLightningTest --output-dir force-app/main/default/lightningTests
```