Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>Browser PanelNew to Visual Studio Code? Get it now.
Browser Panel

Browser Panel

artin

|
232 installs
| (0) | Free
Embedded browser for the VS Code bottom panel / secondary sidebar. Address bar, reload, DevTools (F12) and open-in-external-browser. Defaults to http://localhost:80 for local development preview.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Browser Panel

Open VSX Version Open VSX Downloads Visual Studio Marketplace

Embedded browser for the VS Code bottom panel / secondary sidebar — defaults to http://localhost:80 for local development preview.

Pix Pin 2026 08 22 18 26 26

Features

  • Opens in the bottom panel; drag the tab to the secondary sidebar (VS Code built-in behavior)
  • Address bar with an inline Go arrow (auto-prepends http://)
  • Back / Forward / Reload toolbar icons (official VS Code codicon shapes)
  • Home — returns to the configured default URL
  • DevTools — opens DevTools for the current page
  • Connection-error page — unreachable hosts show a localized error with Open in external browser, plus seamless auto-reconnect (5s countdown / Cancel; retries run in the background without hiding the error overlay). A progress bar shows while loading
  • 「...」menu:
    • Settings
    • Open in external browser
    • Zoom in / Zoom out / Reset zoom
    • Device emulation — viewport presets (iPhone / Pixel / iPad / Surface Duo) + custom width×height inputs; Responsive shows the current container size
    • History — native QuickPick grouped by day with built-in search (limit configurable, default 200)
    • Clear storage — clears this extension's history & last URL (see limitation below)
    • Close browser — unloads the page to free memory and stays closed (state is remembered: the next open restores the last URL, not the default); press Home/Reopen to come back
  • Remembers the last URL and the closed state across VS Code restarts
  • UI follows the VS Code theme (light/dark) and display language (中文 / English)

Usage

  1. Run the command Browser: Open Browser from the Command Palette, or click the Browser tab in the bottom panel.
  2. Navigate to http://localhost:80 (or any http/https page).

Settings

Setting Default Description
browser.defaultUrl http://localhost:80 Default URL (Home target). Change the port by editing the URL.
browser.retainContextWhenHidden true Keep page state (scroll, forms, JS state) alive while the view is hidden. Set to false and collapse the panel to fully release the page when unused. Takes effect after reload.
browser.proxyEnabled false Render sites that refuse to be framed by routing them through a local per-target proxy (http://t-<12hex>.localhost:<port>). Strips framing headers, rewrites nested iframes, holds server-side session cookies per target origin in OS-encrypted SecretStorage (clear via Browser: Clear Proxied Logins), and accepts self-signed local dev certs. The port is sticky, so each proxied site's localStorage and browser cache survive editor restarts. Details: docs/PROXY.md.

Close vs. hidden: a webview view is hidden when it leaves the layout — switching the panel tab to Terminal, collapsing the panel, switching the activity bar away (minimizing the OS window does not count). retainContextWhenHidden decides what happens then. Close browser is different: it unloads the page to free memory and remembers the last URL. Scroll position cannot survive an unload (cross-origin iframe — VS Code cannot read it).

Known limitations

  • Framing-blocked sites (X-Frame-Options, CSP frame-ancestors, or a server-side check on Sec-Fetch-Dest) show a "Site cannot be embedded" page unless browser.proxyEnabled is on. Sites that block by JS, or that need a login, can still come up blank — use Open in external browser.
  • Proxied pages run on http://t-<12hex>.localhost:<port>. Sites that check for an exact https:// origin or real 127.0.0.1/localhost hostname behave accordingly.
  • External browser logins & OAuth do not carry over. The panel and your normal browser are separate processes with separate cookie stores. In proxy mode, server-side Set-Cookie sessions made inside the panel are held per target origin by the extension host (SecretStorage), while third-party OAuth flows still require Open in external browser.
  • New tabs and target=_blank / _top / _parent (including inside same-origin and cross-origin child iframes) go to the system browser when the proxy is on. With the proxy off, the webview sandbox drops them silently — use the menu Open in external browser. Flows that need a real browser OAuth session (Google, PayPal, Microsoft sign-in) do not work in the panel either way.
  • Find in page is unavailable: the embedded page is a cross-origin iframe, which the webview's find widget cannot search. Service Workers, downloads, notifications, alert / confirm / prompt and some device APIs also do not work.
  • Clear storage clears this extension's history, last URL, and closed state (shared across workspaces); use Browser: Clear Proxied Logins to clear proxy-held session cookies.
  • Protocols: http and https only; file:// is not supported. After an in-frame redirect, the address bar keeps the URL you typed (the final URL of a cross-origin iframe is unreadable).
  • Mechanisms, measurements and edge cases: docs/PROXY.md.

Development

npm install
npm run watch     # or: npm run build
npm test          # proxy and webview unit checks

Press F5 in VS Code to launch the Extension Development Host.

To ship a version: bump version in package.json, then push a tag with the same number (0.4.5, no v prefix). The Publish extension workflow packages the vsix once, publishes that file to the Marketplace, and attaches it to a GitHub release whose notes come from the matching CHANGELOG.md section. The run aborts when the tag and package.json disagree.

License

MIT

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft