From 3c9d5cdc66b42b0dbfc8a696217598d753208ff4 Mon Sep 17 00:00:00 2001 From: Max Schmitt Date: Tue, 27 Jul 2021 17:22:08 +0200 Subject: [PATCH] docs: hide language specific docs pages (#7860) --- docs/src/cheat-sheet.md | 302 ------------------ ...ions.md => chrome-extensions-js-python.md} | 0 docs/src/{library.md => library-js.md} | 0 docs/src/{mobile.md => mobile-js.md} | 0 .../{test-advanced.md => test-advanced-js.md} | 0 ...-annotations.md => test-annotations-js.md} | 0 docs/src/{test-cli.md => test-cli-js.md} | 0 ...figuration.md => test-configuration-js.md} | 0 .../{test-fixtures.md => test-fixtures-js.md} | 0 .../{test-install.md => test-install-js.md} | 0 .../{test-parallel.md => test-parallel-js.md} | 0 docs/src/{test-pom.md => test-pom-js.md} | 0 ...test-reporters.md => test-reporters-js.md} | 0 .../{test-retries.md => test-retries-js.md} | 0 ...test-snapshots.md => test-snapshots-js.md} | 0 ...oubleshooting.md => troubleshooting-js.md} | 0 16 files changed, 302 deletions(-) delete mode 100644 docs/src/cheat-sheet.md rename docs/src/{chrome-extensions.md => chrome-extensions-js-python.md} (100%) rename docs/src/{library.md => library-js.md} (100%) rename docs/src/{mobile.md => mobile-js.md} (100%) rename docs/src/{test-advanced.md => test-advanced-js.md} (100%) rename docs/src/{test-annotations.md => test-annotations-js.md} (100%) rename docs/src/{test-cli.md => test-cli-js.md} (100%) rename docs/src/{test-configuration.md => test-configuration-js.md} (100%) rename docs/src/{test-fixtures.md => test-fixtures-js.md} (100%) rename docs/src/{test-install.md => test-install-js.md} (100%) rename docs/src/{test-parallel.md => test-parallel-js.md} (100%) rename docs/src/{test-pom.md => test-pom-js.md} (100%) rename docs/src/{test-reporters.md => test-reporters-js.md} (100%) rename docs/src/{test-retries.md => test-retries-js.md} (100%) rename docs/src/{test-snapshots.md => test-snapshots-js.md} (100%) rename docs/src/{troubleshooting.md => troubleshooting-js.md} (100%) diff --git a/docs/src/cheat-sheet.md b/docs/src/cheat-sheet.md deleted file mode 100644 index 6468ebae32..0000000000 --- a/docs/src/cheat-sheet.md +++ /dev/null @@ -1,302 +0,0 @@ ---- -id: cheat-sheet -title: "Cheat Sheet" ---- - - - -## Download & Upload - -### Download file - -```js -const [ download ] = await Promise.all([ - page.waitForEvent('download'), - page.click('button') -]); -const path = await download.path(); -``` - -```python async -async with page.expect_download() as download_info: - await page.click("button") -download = await download_info.value -path = await download.path() -``` - -```python sync -with page.expect_download() as download_info: - page.click("button") -download = download_info.value -path = download.path() -``` - -```csharp -var waitForDownloadTask = page.WaitForDownloadAsync(); -await page.ClickAsync("#downloadButton"); -var download = await waitForDownloadTask; -var path = await download.PathAsync(); -``` - -[Learn more](./downloads.md) - -### Upload file - -```js -await page.setInputFiles('input#upload', 'myfile.pdf'); -``` - -```java -page.setInputFiles("input#upload", Paths.get("myfile.pdf")); -``` - -```python async -await page.set_input_files('input#upload', 'myfile.pdf') -``` - -```python sync -page.set_input_files('input#upload', 'myfile.pdf') -``` - -```csharp -await page.SetInputFilesAsync("input#upload", "myfile.pdf"); -``` - -[Learn more](./input#upload-files) - -### Upload multiple files - -```js -await page.setInputFiles('input#upload', ['file1.txt', 'file2.txt']); -``` - -```java -page.setInputFiles("input#upload", new Path[] {Paths.get("file1.txt"), Paths.get("file2.txt")}); -``` - -```python async -await page.set_input_files('input#upload', ['file1.txt', 'file2.txt']) -``` - -```python sync -page.set_input_files('input#upload', ['file1.txt', 'file2.txt']) -``` - -```csharp -await page.SetInputFilesAsync("input#upload", new[] { "file1.txt", "file12.txt" }); -``` - -[Learn more](./input#upload-files) - -### Upload from memory - -```js -await page.setInputFiles('input#upload', { - name: 'file.txt', - mimeType: 'text/plain', - buffer: Buffer.from('this is test') -}); -``` - -```java -page.setInputFiles("input#upload", new FilePayload( - "file.txt", "text/plain", "this is test".getBytes(StandardCharsets.UTF_8))); -``` - -```python async -await page.set_input_files( - "input#upload", - files=[ - {"name": "test.txt", "mimeType": "text/plain", "buffer": b"this is a test"} - ], -) -``` - -```python sync -page.set_input_files( - "input#upload", - files=[ - {"name": "test.txt", "mimeType": "text/plain", "buffer": b"this is a test"} - ], -) -``` - -```csharp -await page.SetInputFilesAsync("input#upload", new FilePayload -{ - Name = "file.txt", - MimeType = "text/plain", - Buffer = System.Text.Encoding.UTF8.GetBytes("this is a test"), -}); -``` - -[Learn more](./input#upload-files) - -### Remove selected files - -```js -await page.setInputFiles('input#upload', []); -``` - -```java -page.setInputFiles("input#upload", new Path[0]); -``` - -```python async -await page.set_input_files('input#upload', []) -``` - -```python sync -page.set_input_files('input#upload', []) -``` - -```csharp -await page.SetInputFilesAsync("input#upload", new[] {}); -``` - -[Learn more](./input#upload-files) - -### Handle file picker - -```js -const [fileChooser] = await Promise.all([ - page.waitForEvent('filechooser'), - page.click('upload') -]); -await fileChooser.setFiles('myfile.pdf'); -``` - -```java -FileChooser fileChooser = page.waitForFileChooser(() -> { - page.click("upload"); -}); -fileChooser.setFiles(Paths.get("myfile.pdf")); -``` - -```python async -async with page.expect_file_chooser() as fc_info: - await page.click("upload") -file_chooser = await fc_info.value -await file_chooser.set_files("myfile.pdf") -``` - -```python sync -with page.expect_file_chooser() as fc_info: - page.click("upload") -file_chooser = fc_info.value -file_chooser.set_files("myfile.pdf") -``` - -```csharp -var fileChooser = page.RunAndWaitForFileChooserAsync(async () => -{ - await page.ClickAsync("upload"); -}); -await fileChooser.SetFilesAsync("myfile.pdf"); -``` - -[Learn more](./input#upload-files) - - -## Manage <iframe>s - -### List frames - -```js -const frames = page.frames(); -``` - -```java -List frames = page.frames(); -``` - -```python async -frames = page.frames -``` - -```python sync -frames = page.frames -``` - -```csharp -var frame = page.Frames; -``` - -[Learn more](./core-concepts#pages-and-frames) - -### Frame by `name` attribute - -```js -const frame = page.frame('frame-login'); -``` - -```java -Frame frame = page.frame("frame-login"); -``` - -```python async -frame = page.frame('frame-login') -``` - -```python sync -frame = page.frame('frame-login') -``` - -```csharp -var frame = page.Frame("frame-login"); -``` - -[Learn more](./core-concepts#pages-and-frames) - -### Frame by URL - -```js -const frame = page.frame({ url: /.*domain.*/ }); -``` - -```java -Frame frame = page.frameByUrl(Pattern.compile(".*domain.*")); -``` - -```python async -frame = page.frame(url=r'.*domain.*') -``` - -```python sync -frame = page.frame(url=r'.*domain.*') -``` - -```csharp -var frame = page.FrameByUrl("*domain."); -``` - -[Learn more](./core-concepts#pages-and-frames) - -### Frame by selector - -```js -const frameElementHandle = await page.$('.frame-class'); -const frame = await frameElementHandle.contentFrame(); -``` - -```java -ElementHandle frameElementHandle = page.querySelector(".frame-class"); -Frame frame = frameElementHandle.contentFrame(); -``` - -```python async -frame_element_handle = await page.query_selector('.frame-class') -frame = await frame_element_handle.content_frame() -``` - -```python sync -frame_element_handle = page.query_selector('.frame-class') -frame = frame_element_handle.content_frame() -``` - -```csharp -var frameElementHandle = await page.QuerySelectorAsync(".frame-class"); -var frame = await frameElementHandle.ContentFrameAsync(); -``` - -[Learn more](./core-concepts#pages-and-frames) diff --git a/docs/src/chrome-extensions.md b/docs/src/chrome-extensions-js-python.md similarity index 100% rename from docs/src/chrome-extensions.md rename to docs/src/chrome-extensions-js-python.md diff --git a/docs/src/library.md b/docs/src/library-js.md similarity index 100% rename from docs/src/library.md rename to docs/src/library-js.md diff --git a/docs/src/mobile.md b/docs/src/mobile-js.md similarity index 100% rename from docs/src/mobile.md rename to docs/src/mobile-js.md diff --git a/docs/src/test-advanced.md b/docs/src/test-advanced-js.md similarity index 100% rename from docs/src/test-advanced.md rename to docs/src/test-advanced-js.md diff --git a/docs/src/test-annotations.md b/docs/src/test-annotations-js.md similarity index 100% rename from docs/src/test-annotations.md rename to docs/src/test-annotations-js.md diff --git a/docs/src/test-cli.md b/docs/src/test-cli-js.md similarity index 100% rename from docs/src/test-cli.md rename to docs/src/test-cli-js.md diff --git a/docs/src/test-configuration.md b/docs/src/test-configuration-js.md similarity index 100% rename from docs/src/test-configuration.md rename to docs/src/test-configuration-js.md diff --git a/docs/src/test-fixtures.md b/docs/src/test-fixtures-js.md similarity index 100% rename from docs/src/test-fixtures.md rename to docs/src/test-fixtures-js.md diff --git a/docs/src/test-install.md b/docs/src/test-install-js.md similarity index 100% rename from docs/src/test-install.md rename to docs/src/test-install-js.md diff --git a/docs/src/test-parallel.md b/docs/src/test-parallel-js.md similarity index 100% rename from docs/src/test-parallel.md rename to docs/src/test-parallel-js.md diff --git a/docs/src/test-pom.md b/docs/src/test-pom-js.md similarity index 100% rename from docs/src/test-pom.md rename to docs/src/test-pom-js.md diff --git a/docs/src/test-reporters.md b/docs/src/test-reporters-js.md similarity index 100% rename from docs/src/test-reporters.md rename to docs/src/test-reporters-js.md diff --git a/docs/src/test-retries.md b/docs/src/test-retries-js.md similarity index 100% rename from docs/src/test-retries.md rename to docs/src/test-retries-js.md diff --git a/docs/src/test-snapshots.md b/docs/src/test-snapshots-js.md similarity index 100% rename from docs/src/test-snapshots.md rename to docs/src/test-snapshots-js.md diff --git a/docs/src/troubleshooting.md b/docs/src/troubleshooting-js.md similarity index 100% rename from docs/src/troubleshooting.md rename to docs/src/troubleshooting-js.md