chore: add install no browsers prompt

src/cli.ts

@@ -35,9 +35,28 @@ import { Generator } from './generator';
       options[name] = [];
   }
   const rootDir = path.resolve(process.cwd(), args[0] || '');
+  if (options.help) {
+    _printHelp();
+    process.exit(1);
+  }
   const generator = new Generator(rootDir, options);
   await generator.run();
 })().catch(error => {
   console.error(error);
   process.exit(1);
 });
+
+function _printHelp() {
+  console.log(`Usage: npx create-playwright@latest [options] [rootDir]
+    Available options are:
+      --help: print this message
+      --browser=<name>: browsers to use in default config (default: 'chromium,firefox,webkit')
+      --no-browsers: do not download browsers (can be done manually via 'npx playwright install')
+      --next: install @next version of Playwright
+      --beta: install @beta version of Playwright
+      --ct: install Playwright Component testing
+      --quiet: do not ask for interactive input prompts
+      --gha: install GitHub Actions
+      --lang=<js>: language to use (default: 'TypeScript'. Potential values: 'js', 'TypeScript')
+    `);
+}

src/generator.ts

@@ -28,6 +28,7 @@ export type PromptOptions = {
   language: 'JavaScript' | 'TypeScript',
   framework?: 'react' | 'vue' | 'svelte' | undefined,
   installPlaywrightDependencies: boolean,
+  installPlaywrightBrowsers: boolean,
 };
 
 const assetsDir = path.join(__dirname, '..', 'assets');
@@ -67,6 +68,7 @@ export class Generator {
         installPlaywrightDependencies: !!this.options['install-deps'],
         testDir: fs.existsSync(path.join(this.rootDir, 'tests')) ? 'e2e' : 'tests',
         framework: undefined,
+        installPlaywrightBrowsers: !this.options['no-browsers'],
       };
     }
 
@@ -104,12 +106,18 @@ export class Generator {
         message: 'Add a GitHub Actions workflow?',
         initial: false,
       },
+      {
+        type: 'confirm',
+        name: 'installPlaywrightBrowsers',
+        message: 'Install Playwright browsers (can be done manually via \'npx playwright install\')?',
+        initial: true,
+      },
       // Avoid installing dependencies on Windows (vast majority does not run create-playwright on Windows)
       // Avoid installing dependencies on Mac (there are no dependencies)
       process.platform === 'linux' && {
         type: 'confirm',
         name: 'installPlaywrightDependencies',
-        message: 'Install Playwright operating system dependencies (requires sudo / root - can be done manually via \sudo npx playwright install-deps\')?',
+        message: 'Install Playwright operating system dependencies (requires sudo / root - can be done manually via \'sudo npx playwright install-deps\')?',
         initial: false,
       },
     ];
@@ -191,10 +199,12 @@ export class Generator {
     }
 
     const browsersSuffix = this.options.browser ? ' ' + this.options.browser.join(' ') : '';
-    commands.push({
-      name: 'Downloading browsers',
-      command: 'npx playwright install' + (answers.installPlaywrightDependencies ? ' --with-deps' : '') + browsersSuffix,
-    });
+    if (answers.installPlaywrightBrowsers) {
+      commands.push({
+        name: 'Downloading browsers',
+        command: 'npx playwright install' + (answers.installPlaywrightDependencies ? ' --with-deps' : '') + browsersSuffix,
+      });
+    }
 
     return { files, commands };
   }

tests/integration.spec.ts

@@ -19,7 +19,7 @@ import fs from 'fs';
 
 test('should generate a project in the current directory', async ({ run, packageManager }) => {
   test.slow();
-  const { exitCode, dir, stdout } = await run([], { installGitHubActions: true, testDir: 'tests', language: 'TypeScript', installPlaywrightDependencies: false });
+  const { exitCode, dir, stdout } = await run([], { installGitHubActions: true, testDir: 'tests', language: 'TypeScript', installPlaywrightDependencies: false, installPlaywrightBrowsers: true });
   expect(exitCode).toBe(0);
   expect(fs.existsSync(path.join(dir, 'tests/example.spec.ts'))).toBeTruthy();
   expect(fs.existsSync(path.join(dir, 'package.json'))).toBeTruthy();
@@ -48,7 +48,7 @@ test('should generate a project in the current directory', async ({ run, package
 });
 
 test('should generate a project in a given directory', async ({ run, packageManager }) => {
-  const { exitCode, dir } = await run(['foobar'], { installGitHubActions: true, testDir: 'tests', language: 'TypeScript', installPlaywrightDependencies: false });
+  const { exitCode, dir } = await run(['foobar'], { installGitHubActions: true, testDir: 'tests', language: 'TypeScript', installPlaywrightDependencies: false, installPlaywrightBrowsers: true });
   expect(exitCode).toBe(0);
   expect(fs.existsSync(path.join(dir, 'foobar/tests/example.spec.ts'))).toBeTruthy();
   expect(fs.existsSync(path.join(dir, 'foobar/package.json'))).toBeTruthy();
@@ -63,7 +63,7 @@ test('should generate a project in a given directory', async ({ run, packageMana
 });
 
 test('should generate a project with JavaScript and without GHA', async ({ run, packageManager }) => {
-  const { exitCode, dir } = await run([], { installGitHubActions: false, testDir: 'tests', language: 'JavaScript', installPlaywrightDependencies: false });
+  const { exitCode, dir } = await run([], { installGitHubActions: false, testDir: 'tests', language: 'JavaScript', installPlaywrightDependencies: false, installPlaywrightBrowsers: true });
   expect(exitCode).toBe(0);
   expect(fs.existsSync(path.join(dir, 'tests/example.spec.js'))).toBeTruthy();
   expect(fs.existsSync(path.join(dir, 'package.json'))).toBeTruthy();
@@ -79,7 +79,7 @@ test('should generate a project with JavaScript and without GHA', async ({ run,
 
 test('should generate be able to run TS examples successfully', async ({ run, packageManager }) => {
   test.slow();
-  const { exitCode, dir, exec } = await run([], { installGitHubActions: false, testDir: 'tests', language: 'TypeScript', installPlaywrightDependencies: false });
+  const { exitCode, dir, exec } = await run([], { installGitHubActions: false, testDir: 'tests', language: 'TypeScript', installPlaywrightDependencies: false, installPlaywrightBrowsers: true });
   expect(exitCode).toBe(0);
   expect(fs.existsSync(path.join(dir, 'tests/example.spec.ts'))).toBeTruthy();
   expect(fs.existsSync(path.join(dir, 'package.json'))).toBeTruthy();
@@ -96,7 +96,7 @@ test('should generate be able to run TS examples successfully', async ({ run, pa
 
 test('should generate be able to run JS examples successfully', async ({ run, packageManager }) => {
   test.slow();
-  const { exitCode, dir, exec } = await run([], { installGitHubActions: false, testDir: 'tests', language: 'JavaScript', installPlaywrightDependencies: false });
+  const { exitCode, dir, exec } = await run([], { installGitHubActions: false, testDir: 'tests', language: 'JavaScript', installPlaywrightDependencies: false, installPlaywrightBrowsers: true });
   expect(exitCode).toBe(0);
   expect(fs.existsSync(path.join(dir, 'tests/example.spec.js'))).toBeTruthy();
   expect(fs.existsSync(path.join(dir, 'package.json'))).toBeTruthy();