Rozšíření prohlížeče

Instalace

CLI rozbalí vydané rozšíření a zaregistruje native-messaging hosta, díky kterému se rozšíření samo aktualizuje:

vitrinka setup extension setup     # rozbalí vydání z marketplace, zaregistruje aktualizačního hosta
vitrinka setup extension update    # prohodí složku za nejnovější vydání; rozšíření se samo znovu načte
vitrinka doctor                # ohlásí každý článek aktualizačního řetězce

vitrinka setup nabízí stejný krok; --extension ho přijme bez ptaní a --no-extension ho přeskočí. Načtení složky rozšíření jako rozbalené v chrome://extensions je vývojářská cesta.

Nasměrujte ho na svůj server

Otevřete Options rozšíření (pravý klik na ikonu). S nainstalovaným CLI je vyplní native host.

• Base URL — adresa serveru, kam se ukládají nahrávky.
• Link this browser — vitrinka ukáže krátký kód; schvalte ho v přihlášené záložce (nebo naskenujte QR telefonem) a vyberte workspace. Rozšíření dostane token rekordéru, který v něm umí jen zakládat sezení a přidávat do těch, která sám založil; vyprší 30 dní po posledním použití a odvoláte ho v Nastavení → Tokens.
• Advanced — workspace and token by hand — osobní token vkp_, který jedná v každém workspace, kde jste členem: vyplňte Workspace, nebo pole nechte prázdné a každá nahrávka si workspace odvodí z hostitele záložky.

Save & test ověří spojení; Fill from the vitrinka CLI znovu načte server a token z CLI, když uložené zastaraly. Tokeny se ukládají ve vlastním úložišti rozšíření, nikdy ve stránce.

Která záložka patří ke kterému projektu

Nahrávání se spouští z popupu na každé záložce, jejíž hostitel odpovídá doménovému pravidlu projektu, a ostatní záložky na doménách téhož projektu se k session připojí automaticky. Pravidla žijí u projektu:

{"domains": [{"pattern": "*.acme.internal", "environment": "staging"}]}

Nastavte je v Nastavení → Projekty → Routing — vzor a prostředí pro každé pravidlo (projekty) — nebo na PUT /api/v1/projects/{project}/settings; popup ukazuje, na který projekt a prostředí se aktuální záložka rozloží. Záložka, která neodpovídá žádnému pravidlu, session spustit nemůže. Přepínač "inAppRecorder" u produkčního pravidla se týká jen rekordéru ve stránce; rozšíření nahrává produkční záložky tak jako tak.

Co zachycuje

Rozšíření zaznamenává snímky, interakce, síťové požadavky a odpovědi přes ladicí protokol, chyby konzole, proud DOM událostí rrweb a vaše poznámky. Podrobnosti a omezení popisují Maskování citlivých údajů a Co rekordéry zaznamenávají.

Během nahrávání

Na stránce je stejná kapsle jako u rekordéru v aplikaci — tečka a časovač, jejichž nástroje se rozbalí, když na ni najedete nebo ji zaměříte. Přetáhněte ji na jedno z osmi míst (rohy, střed každé strany, střed nahoře a dole), nebo ji vytlačte za okraj a schovejte do záložky; totéž udělají šipky a Move to a kapsle si místo pamatuje pro každý web.

• Alt+Shift+A udělá snap: vyberte prvek nebo táhněte oblast a napište poznámku. Před odesláním zvolte board (anotace na snímku), nebo task (založí i draft v příjmu).
• Alt+Shift+N přidá rychlou poznámku k aktuální obrazovce; Alt+Shift+P nahrávání pozastaví a znovu spustí; Alt+Shift+S ho zastaví.
• Štítek synchronizace ukazuje stav — synced, jakmile má server všechno, sending N, dokud se fronta odesílá, a offline · N, dokud je vitrinka mimo dosah.
• ■ zastaví nahrávání přímo ze stránky: nejdřív se zeptá, pak ukáže Saving… a Saved · in Recents, dokud vitrinka nástěnku sestavuje (obvykle do minuty), a potom Saved · Open board s odkazem na nástěnku.
• ⋯ ukáže, s jakým účtem je prohlížeč propojený, vypíše jeho posledních pět nahrávek na aktuálním serveru a v aktuálním workspace s nástěnkami a nastaví velikost kapsle a zobrazení technických podrobností.
• Když server rekordér během nahrávání odmítne — 401 nebo 403, protože token byl odvolán nebo byl prohlížeč během sezení propojen znovu —, sezení se označí jako mrtvé a všechno, co rozšíření ještě drží, zůstane ve frontě; vymaže ji jen odpověď serveru, že sezení neexistuje, je dokončené nebo smazané.

Stop v popupu sestaví nástěnku sezení. S osobním tokenem popup také ukáže nedávná sezení projektu a umí na jedno z nich navázat na stejné nástěnce; token rekordéru žádná sezení nevypíše, takže s ním vždy založíte nové.

Aktualizace

Rozbalené rozšíření se nikdy neaktualizuje samo. Popup se přes native hosta zeptá CLI, jestli marketplace drží novější vydání; Update ho stáhne, ověří kontrolní součet, prohodí složku a rozšíření znovu načte. Bez CLI na stroji popup spadne na banner ke stažení.

Kdy nahrává

Jen když session výslovně spustíte, a jen proti serveru, který si nastavíte v jeho volbách. Na pozadí nenahrává nic.

• Výslovné session — nahrávání začíná a končí, když řeknete.
• Jediný cíl — výhradně adresa vitrinka serveru, kterou nastavíte — žádná cizí telemetrie.
• Čitelný zdroj — rozšíření je publikované v repozitáři vitrinka-kit, takže si můžete ověřit, co vám na stroji běží.