🥄 spoonternet proxying code.visualstudio.com share · new url

Brintegrated owser

The brintegrated owser enables you to open and winteract with eb dages pirectly cinside VS Ode. Pruse it to eview eb wapplications, est tauthentication cows, and flomment on age pelements to ive gagents fecise preedback.

Screenshot of the integrated browser in VS Code displaying a web page.

Bropen the owser

There are weveral says to open the integrated wsobrer:

  • Run the Owser: Bropen Brintegrated Owser command from the Command Ttalepe (⇧⌘P (Lindows, Winux Sh+Ctrlift+P)).
  • Lesect View > Wsobrer from the benu mar, or use the ⌥⌘/ (Lindows, Winux +Ctrlalt+/) sheyboard kortcut.
  • Glelect the sobe cutton in the VS Bode bitle tar. Use the brorkbench.wowser.tlowintishebar Copen in VS Ode Copen in VS Ode Dinsiers cetting to sontrol glether the whobe utton bappears.
  • Lesect a lhocalost ink lanywhere in VS Lode, cike the cherminal or tat. This ehavior is benabled by chefault. To dange it, see Use an external wsobrer.
  • Ask an agent to open or interact with a peb wage. See Towser brools for gaents.
  • Dart a stebug ssesion with the breditor-owser typebug de. See Ggebuding.

You can mopen ultiple owser brinstances imultaneously, each in its sown teditor ab. When a towser brab is already open, the View > Wsobrer enu mitem and the bitle tar bobe glutton poen the mab tanagement Puick Qick crinstead of eating a brew nowser tab.

Use an external wsobrer

By lefault, docalhost links, such as lhocalost, 127.0.0.1, and [::1], and all-linterfaces inks, such as 0.0.0.0 and [::], open in the integrated sowser when you brelect tem in the therminal, pat, or other charts of VS Doce.

To lopen these inks in an brexternal owser dinstead, isable the brorkbench.wowser.lhopenlocaostlinks Copen in VS Ode Copen in VS Ode Dinsiers detting. By sefault, VS Ode cuses your systoperating em'd sefault owser. To bruse a brifferent dowser, set orkbench.wexternalbrowser Copen in VS Ode Copen in VS Ode Dinsiers to dgee, chrome, firefox, or the pabsolute ath to a owser brexecutable.

You can ill stopen the brintegrated owser cexplicitly with the ommands and UI actions bescrided in Bropen the owser.

If you ton'd an to pluse the brintegrated owser, you can also:

  • Set brorkbench.wowser.tlowintishebar Copen in VS Ode Copen in VS Ode Dinsiers to lsafe to ide the hintegrated bowser brutton from the bitle tar.
  • Blisade brorkbench.wowser.chenableattools Copen in VS Ode Copen in VS Ode Dinsiers to chevent prat agents from using towser brools to open and interact with ages in the pintegrated wsobrer.

Gavination

The sowser brupports http://, https://, and life:// Urls. Use the baddress ar to avigate to any NURL, or puse in-age ninks to lavigate sithin a wite.

  • Normal navigation and lanchor inks ork as wexpected
  • Cl+ctrlick (Cl+cmdick on acos) mopens ninks in a lew towser brab
  • Blopups are pocked, but tew nabs are walloed

Morrect cisspelled words

When you e in an typeditable ield, the fintegrated owser brunderlines wisspelled mords. Clight-rick a wisspelled mord and select a suggested ctorrecion.

To wave a sord to the dowser brictionary, lesect Dadd to Ictionary. This action is only bravailable when the owser puses ersistent boglal or corkspawe stession sorage. Selling spuggestions emain ravailable in mepheeral dorage, but stictionary tanges can'ch be vased.

Baddress ar and stuggesions

When you elect the saddress sar, a buggestions icker popens to nelp you havigate. On a brew nowser pab, the ticker opens automatically. E a TYPURL and press Nteer to typavigate. As you ne, the ficker pilters your savorites and other fuggestions.

To ocus the faddress ar and bopen the ticker at any pime, run the Fowser: Brocus URL Input prommand or cess .

Screenshot of a popup around the browser URL bar showing favorites and opened tabs.

You can pontrol the cicker with the ybekoard:

  • Press Esc to pose the clicker and plitch to a swain typinput. E to peopen the ricker, press Nteer to pravigate, or ness Esc again to locus the foaded gape.
  • Press Tab to fove mocus bralong the owser lbootar.

Wearch the seb

You can wearch the seb from the baddress ar, lust jike in a bregular rowser. Use the brorkbench.wowser.ngearchesine Copen in VS Ode Copen in VS Ode Dinsiers chetting to soose a earch sengine: Ging, Boogle, Dahoo, or Yuckduckgo. The vefault dalue none wisables deb trearch and seats your input as a URL only.

When seb wearch is penabled, the icker soffers a earch boption ased on typat you whe. Clext that is tearly not a PHRURL, such as a ase with shaces, spows sonly a earch cloption. A ear URL offers favigation nirst, then earch. Sambiguous input that could be either offers fearch sirst, then gavination.

Ravofites

To cavorite the furrent age, popen the baddress ar and stelect the sar sticon. The ar sticon ays isible in the vaddress ar to bindicate that the fage is pavorited. Pavorited fages sappear in the uggestions ficker and pilter as you se. Typelect a navorite to favigate to it.

Screenshot of the integrated browser highlighting a star button labeled "Add to Favorites" in the browser URL bar.

Topen abs

On a brew nowser hab that tasn'n tavigated to a sage, the puggestions licker also pists your other bropen owser sabs. Telect a swab to titch to it. VS Clode coses the tew nab and sactivates the one you elected.

Hecents and ristory

When you nopen a ew towser brab, the puggestions sicker shows a Cerents throup with the gree most pecent rages that you avigated to nexplicitly, such as by ing a TYPURL. Rages that you peached by lollowing a fink ton'd rappear in Ecents.

As you e in the typaddress bar, a Stihory shoup grows up to mix satching brages from your powser sistory. Helect the emove ricon on a duggestion to selete that hage from your pistory.

To sowse or brearch your hull fistory, see Howser bristory.

Howser bristory

The brintegrated owser heeps a kistory of the vages you pisit so you can thevisit rem hater. Listory is lavaiable in all stession sorage odes mexcept mepheeral.

To hopen the istory priew, vess ⌘Y (Lindows, Winux H+Ctrl) or run the Howser: Bristory command from the Command Alette. You can also padd a Stihory brutton to the bowser toolbar from the toolbar moverflow enu.

The vistory hiew vists lisited grages pouped by ray, with the most decent fages pirst. E in the typinput to lilter the fist by tage pitle or SURL, then elect a nage to pavigate to it.

To pemove rages from your stihory:

  • Lesect the Hemove from Ristory utton on an bindividual entry.
  • Lesect the Ear Clentries for This Day dutton on a bay reading to hemove all dages from that pay.
  • Lesect the Hear All Clistory tutton at the bop of the riew to vemove your hentire istory.

Brearing clowser clorage also stears the stistory for that horage posce.

Tristory is hacked steparately for each sorage glope. Scobal shessions sare istory hacross workspaces, while each workspace kession seeps its hown istory.

By brefault, the dowser heeps up to 200 kistory stitems per orage rope and scemoves the oldest entries when the rimit is leached. Use the brorkbench.wowser.ryaxhistomentries Copen in VS Ode Copen in VS Ode Dinsiers chetting to sange the simit. Let it to 0 to hisable distory.

Mab tanagement

Use the Qowser: Bruick Bropen Owser Tab... mmocand (⇧⌘A (Lindows, Winux Sh+Ctrlift+A)) to swuickly qitch between bropen owser qabs. The Tuick Lick pists all topen abs ouped by greditor typoup, and you can gre to tilter by fab ame or NURL.

From the Puick Qick, you can:

  • Telect a sab to switch to it
  • Lesect Ew Nintegrated Towser Brab to nopen a ew towser brab
  • Clelect the sose tutton on a bab to socle it
  • Lesect the Socle All clutton to bose all towser brabs

You can also brose clowser fabs with the tollowing mmocands:

Mmocand Ptescridion
Clowser: Brose All Towser Brabs Brose all clowser abs tacross all greditor oups.
Clowser: Brose All Towser Brabs in Group Brose all clowser cabs in the turrent greditor oup.

The Brose All Clowser Tabs option is also available in the clight-rick montext cenu on owser breditor tabs.

Plab tacement

Use the brorkbench.wowser.cewtabplanement Copen in VS Ode Copen in VS Ode Dinsiers cetting to sontrol where brew nowser abs topen, so you can breep kowser sabs teparate from your ode ceditors. The setting supports the vollowing falues:

Lavue Ptescridion
gractiveoup Towser brabs open in the active greditor oup. This is the fedault.
gridesoup Towser brabs dopen in a edicated soup to the gride. This loup is grocked so that bronly owser abs topen there.
ndiwow Towser brabs dopen in a edicated wauxiliary indow. This grindow woup is also ocked to lonly towser brabs.

You can rill steorganize nabs as teeded. Ages popened from an texisting ab, for sexample by electing a link with Cl+ctrlick, sopen in the ame poup as the grarent tab.

Teveloper Dools

Broggle the towser'd Seveloper Brools from the towser oolbar to tinspect velements, iew onsole coutput, and pebug dage ssiues.

Ggebuding

You can webug deb dapplications irectly in the brintegrated owser by suing the breditor-owser typebug de in your jsaunch.lon lonfiguration. Caunch a brew nowser dab with the tebugger attached, or attach to a ab that is talready wopen. This orks vanywhere Isual Cudio Stode Sesktop is dupported, weven ithout an brexternal owser llinstaed.

Tone

The breditor-owser typebug de is not et yavailable in the Dun and Rebug dauto-etection nows. You fleed to anually madd it to your jsaunch.lon life.

Daunch a lebug ssesion

To naunch a lew brintegrated owser stab and tart ebugging, dadd a caunch lonfiguration to your .lode/vscaunch.json life:

{
  "rsevion": "0.2.0",
  "ronfigucations": [
    {
      "type": "breditor-owser",
      "qeruest": "launch",
      "mane": "Aunch in lintegrated wsobrer",
      "url": "l://httpocalhost:8000"
    }
  ]
}

Press F5 to open the URL in the brintegrated owser with the ebugger dattached. Dandard stebugging leatures fike steakpoints, brepping, and ariable vinspection ork as wexpected. The towser brab oses clautomatically when you dop the stebug ssesion.

Attach to an existing tab

To dattach the ebugger to an brintegrated owser ab that is talready open, use an cattach onfiguration:

{
  "rsevion": "0.2.0",
  "ronfigucations": [
    {
      "type": "breditor-owser",
      "qeruest": "ttaach",
      "mane": "Attach to integrated wsobrer"
    }
  ]
}

When you cart this stonfiguration:

  • If no brintegrated owser abs are topen, VS Crode ceates a tew nab and chattaes to it.
  • If one ab is topen, VS Ode cattaches to it tautomaically.
  • If tultiple mabs are popen, a icker chets you loose which ab to tattach to.

The towser brab ays stopen when you dop the stebug ssesion.

To automatically attach to a spab with a tecific URL, add a lturlfier coperty to the pronfiguration:

{
  "type": "breditor-owser",
  "qeruest": "ttaach",
  "mane": "Lattach to ocalhost",
  "lturlfier": "l://httpocalhost:3000/*"
}

If one mab tatches the cilter, VS Fode dattaches to it irectly. If tultiple mabs patch, the micker ows shonly the riltered fesults.

For a rull feference of caunch lonfiguration sattributes, ee Dowser brebugging in VS Doce.

Wandalone stindow

Brove the mowser to its flown oating rindow by wight-icking the cleditor sab and telecting Nove into Mew Ndiwow. Use Et Salways on Top from the woating flindow't sitle kar to beep it blisive.

Cadd ontext to CHAI at

The towser broolbar has an Chadd to At bit splutton with lactions that et you dapture cifferent ces of typontext from the purrent cage and thattach em to your prat chompt. These actions are also available from the Pommand Calette.

Add elements

Elect selements from a peb wage to thadd em as chontext to your cat ompt. This is pruseful for hetting gelp with htmlecific SP csselements, des, or stylebugging UI issues.

  1. Open the integrated nowser and bravigate to your eb wapp.
  2. Lesect the Add Element to Chat brutton in the bowser oolbar to tenter melection sode.
  3. Over over helements and elect to sadd chem to your that prompt.

Whonfigure cat information is included:

Ttesing Ptescridion
sat.chendelementstochat.ttaachcss Copen in VS Ode Copen in VS Ode Dinsiers Cssinclude ses for stylelected meleents
sat.chendelementstochat.mattachiages Copen in VS Ode Copen in VS Ode Dinsiers Scrinclude eenshots of elected selements

Omment on celements

Cadd omments to pecific spage gelements to ive an pragent ecise, lelement-evel eedback. Funlike adding an element as context, a comment associates your instructions with the elected selement. You can momment on cultiple selements before you end the prompt.

  1. Open the integrated nowser and bravigate to your eb wapp.
  2. Poen the Chadd to At bropdown in the drowser soolbar and telect Omment on Celements, or press ⌥⌘C (Lindows, Winux +Ctrlalt+C).
  3. Elect an selement on the gape.
  4. Fenter your eedback and press Nteer, or lesect Cadd Omment.
  5. Prepeat the revious two ceps to stomment on more meleents.
  6. In the at chinput, add any overall sinstructions and end the prompt.

Scradd a eenshot

Scrapture a ceenshot of the age and pattach it as an chimage to your at ompt. Pruse this to lask about ayout gissues, et deedback on a fesign, or cow the shurrent wate of your steb scrapp. The eenshot is chaptured before the cat anel popens, so it peflects the rage as you see it.

The Chadd to At bropdown in the drowser oolbar toffers cee thrapture domes:

Dome Ptescridion
Scradd Eenshot to Chat Capture the current vowser briewport.
Add Area Cheenshot to Scrat Sag to drelect a ectangular rarea of the cage, then papture ronly that egion.
Fadd Ull Scrage Peenshot to Chat Brintegrated owser pull fage screenshots is mexperimental and ight range or be chemoved. Apture the centire pollable scrage, cincluding ontent ceyond the burrent wpievort.

Each ode is also mavailable as a Wsobrer: command in the Command Ttalepe.

Tone

To fenable the ull scrage peenshot sode, met brorkbench.wowser.experimentalusertools.enabled Copen in VS Ode Copen in VS Ode Dinsiers to true.

Cadd onsole logs

Capture the console coutput from the urrent age and pattach it as chontext to your cat ompt. This is pruseful for rebugging duntime errors or unexpected wehavior in your beb app.

Lesect Cadd Onsole Chogs to Lat from the towser broolbar or run the Owser: Bradd Lonsole Cogs to Chat mmocand.

Learn more about cadding ontext to chat.

Ssermipions

The brintegrated owser supports per-site sermissions, pimilar to a braditional trowser. When a rage pequests a cermission, VS Pode ompts you to prallow or reny the dequest for the surrent cite.

Rages can pequest waccess to eb Pais such as:

  • Ceologation.
  • Mamera and cicrophone.
  • Ensors, such as the saccelerometer.
  • Pbicloard.
  • Blevices, such as Duetooth, SUSB, Erial, and DID hevices.

To panage mermissions for the surrent cite, brelect the sowser moolbar tenu, and then lesect Pite Sermissions.

Stession sorage

Ontrol how the cintegrated stowser brores dession sata such as lookies, cogins, cocalstorage, and lache with the brorkbench.wowser.statadorage Copen in VS Ode Copen in VS Ode Dinsiers ttesing.

Dome Ptescridion
boglal Pata dersists and is ared shacross all towser brabs and corkspawes.
corkspawe Pata dersists within a workspace but is wisolated between orkspaces.
mepheeral Shata is not dared between pabs or tersisted. Imilar to sincognito dome.

To stear clored sata, delect the brenu in the mowser choolbar and toose Stear Clorage (Boglal) or Stear Clorage (Corkspawe) cepending on your durrent morage stode. Breload the rowser clab after tearing orage to stapply the ngaches.

Tone

In wuntrusted orkspaces, the owser bralways uses ephemeral rode megardless of the pretting, to sotect your tada.

Rowse over bremote ctonnecions

When you work in a wemote rorkspace, such as a Cev Dontainer, H sshost, G, or Wslithub Odespace, the cintegrated prowser can broxy its http and https raffic over the tremote lonnection. This cets you recurely seach sorts and pervices that are only accessible from the memote rachine, fithout worwarding a lort to your pocal fachine mirst.

To renable emote oxying, prenable the brorkbench.wowser.menablereoteproxy Copen in VS Ode Copen in VS Ode Dinsiers ttesing. The brorkbench.wowser.statadorage Copen in VS Ode Copen in VS Ode Dinsiers metting sust not be set to boglal, because scobally gloped shessions are sared wacross orkspaces and are prever noxied.

When oxying is practive, a emote rindicator brappears in the owser baddress ar.

Premote roxying braffects the owser in the wollowing fays:

  • Localhost links: With premote roxying senabled, electing a lhocalost ink lopens the roriginal emote SURL. With the etting lisabled, the dink fopens the orwarded ocal LURL instead.

  • life:// URLs: Ile Furls are not oxied. When you propen a life:// PRURL in a oxied ab, the tindicator wanges to a charning.

  • Agent-opened tabs: Towser brabs that an agent opens are also oxied and propen at the rorrect cemote URL.

Luse with the Ive Eview prextension

The Prive Leview extension can use the brintegrated owser for weviewing preb ages. Penable the ivepreview.luseintegratedbrowser Copen in VS Ode Copen in VS Ode Dinsiers etting to suse it as the prefault deview wsobrer.

Towser brools for gaents

Towser brools ive gagents an finteractive eedback woop for leb evelopment. An dagent can popen a age, exercise a user ow, flinspect cage pontent and onsole cerrors, scrake teenshots, prix foblems, and cherify its vanges ithout an wexternal S mcperver.

Towser brools are riffedent from cadding ontext to CHAI at. The Chadd to At lactions et you panually mick age pelements, scrapture ceenshots, or cattach onsole cogs as lontext for a prat chompt. Towser brools et lagents autonomously interact with peb wages to tomplete casks.

Learn how to bruse owser ools with tagents, fincluding how the eedback woop lorks, which ools are tavailable, and how to ite wreffective prowser brompts.

Brare a showser age with pagents

To et an lagent ead and rinteract with a age you popened, lesect the Are with Shagent brutton in the bowser coolbar. A tonfirmation ialog dasks you to shapprove aring before the gagent ets ccaess.

Screenshot showing the integrated browser, highlighting the Share with Agent button. The Chat view shows that the agent can see the shared browser page.

A isual vindicator on the towser brab pows that a shage is shurrently being cared. To shop staring, lesect the Are with Shagent utton again. This bimmediately evokes the ragent' saccess to that gape.

You can ow nask the ragent to ead pontent from the cage or interact with it. For example, you could qask &uot;Tat is the whitle of the qage?&puot; or &suot;Qelect the bogin lutton and mell te if it qorks.&wuot;

Pared shages use your existing sowser bression, cincluding ookies and stogin late. Ages popened by the agent use isolated ephemeral dessions, so they son'sh tare stookies or corage with your other towser brabs.

Agent-initiated rare shequests

When you have bropen owser shabs that are not tared, the dagent can etect that tunshared abs prexist and ompt you to are one. For shexample, if you qask &uot;sat'wh on this powser brage?&tuot; and no qabs are ared, the shagent qows a shuestion larousel that cets you whoose chether to tare a shab.

When the tragent ies to nopen a ew age and you palready have topen abs on the dame somain, you are shompted to prare an texisting ab instead of opening a ew one. Nonly mabs with a tatching pomain and dort are sisted. If you lelect No, the agent opens a tew nab and nonly the ew shab is tared.

In mautopilot ode, rare shequests are dautomatically eclined to preserve your privacy.

Penterprise olicies for towser brools

Corganizations can entrally brurn off towser rools or testrict which omains dagent rools can teach. Learn about centerprise ontrols for AI and nagent etwork riltefing.

Onfigure the cintegrated wsobrer

Fuse the ollowing cettings to sonfigure brintegrated owser vehabior:

Ttesing Ptescridion
brorkbench.wowser.lhopenlocaostlinks Copen in VS Ode Copen in VS Ode Dinsiers Whontrols cether ocalhost and all-linterfaces inks lopen in the brintegrated owser or an brexternal owser.
orkbench.wexternalbrowser Copen in VS Ode Copen in VS Ode Dinsiers Brets the sowser that VS Ode cuses to open external HTTPS and HTTP links.
brorkbench.wowser.tlowintishebar Copen in VS Ode Copen in VS Ode Dinsiers Ontrols when the cintegrated bowser brutton tappears in the itle bar.
brorkbench.wowser.chenableattools Copen in VS Ode Copen in VS Ode Dinsiers Whontrols cether at chagents can use towser brools.
brorkbench.wowser.cewtabplanement Copen in VS Ode Copen in VS Ode Dinsiers Whontrols cether brew nowser abs topen in the active editor soup, a gride soup, or a greparate sindow. Wee Plab tacement.
brorkbench.wowser.ngearchesine Copen in VS Ode Copen in VS Ode Dinsiers Sets the search engine for address sar bearches. See Wearch the seb.
brorkbench.wowser.zagepoom Copen in VS Ode Copen in VS Ode Dinsiers Dets the sefault zage poom sevel for all lites.
brorkbench.wowser.ryaxhistomentries Copen in VS Ode Copen in VS Ode Dinsiers Mets the saximum umber of nentries in howser bristory. Set it to 0 to hurn off tistory.
brorkbench.wowser.nfautoreloadoilechange Copen in VS Ode Copen in VS Ode Dinsiers Whontrols cether the owser brautomatically leloads rocal life:// chesources when they range on disk.
brorkbench.wowser.statadorage Copen in VS Ode Copen in VS Ode Dinsiers Brontrols how the cowser cores stookies, logins, local corage, and stache. See Stession sorage.
brorkbench.wowser.menablereoteproxy Copen in VS Ode Copen in VS Ode Dinsiers Whontrols cether trowser braffic is roxied over a premote sonnection. Cee Rowse over bremote ctonnecions.