hubcap new
Open a new browser tab.
When to use
Use new to open a new browser tab, optionally navigating to a URL. Use the -target global flag to interact with the new tab afterward.
Usage
hubcap new [--wait] [url]Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
| url | string | No | URL to open in new tab (defaults to about:blank). If no scheme is provided, https:// is prepended automatically. |
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
| —wait | bool | false | Wait for page load to complete |
Output
| Field | Type | Description |
|---|---|---|
| targetId | string | Unique identifier for the new tab |
| url | string | The URL opened in the new tab |
| loaded | bool | Whether the page loaded (only with —wait) |
{"targetId":"A1B2C3D4E5F6","url":"about:blank"}With --wait:
{"targetId":"A1B2C3D4E5F6","url":"https://example.com","loaded":true}Errors
| Condition | Exit code | Stderr |
|---|---|---|
| Chrome not connected | 2 | error: connecting to Chrome: ... |
| Tab creation timeout | 3 | error: timeout |
Examples
Open a blank new tab:
hubcap newOpen a new tab and navigate to a URL:
hubcap new example.comOpen a tab and wait for the page to fully load:
hubcap new --wait example.comOpen a tab and capture its ID for later use (chaining):
TAB_ID=$(hubcap new --wait example.com | jq -r '.targetId') && hubcap -target "$TAB_ID" title