Käyttöohje: selainlaajennusten rakentaminen

Priya — kysyit viime viikolla, pitäisikö hintapudotusta seuraavan laajennuksesi vain pollata tuotesivua minuutin välein "varmuuden vuoksi". Ennen kuin rakennat sen sisään, käydään koko asia läpi, sillä pollausväli on itse asiassa pienin päätös tässä — ja se, että saat rakenteen kohdalleen heti alussa, säästää sinulta yhden tai kaksi arviointikierrosta ennen julkaisua.

Aloitetaan itse kehotteesta. Sanoit "laajennus, joka seuraa tätä sivua ja kertoo, kun hinta laskee", ja se on hyvä idea, mutta se ei vielä ole speksi — rakentajan täytyy tietää, milloin se toimii, ei pelkästään mitä se tekee. Seurantasi on kolmas kolmesta laukaisurakenteesta, ja kannattaa tuntea myös kaksi muuta, vaikka et niitä tarvitsekaan, sillä rakenne määrää käyttöoikeudet ja käyttöoikeudet määräävät arviointiaikataulusi.

• Klikkaa toimimaan on halvin vaihtoehto: ponnahdusikkuna, joka toimii kerran nykyistä sivua vastaan, kun joku painaa työkalurivin kuvaketta — ajattele esimerkiksi "kerää kaikki hinnat tältä sivulta listaksi".
• Aina päällä oleva sisältöskripti toimii automaattisesti määrittämääsi URL-kaavaa vastaavilla sivuilla — hyvä esimerkiksi kilpailijan nimen korostamiseen jokaisella verkkotunnuksen alaisella sivulla, mutta kaava on ilmoitettava tarkasti, koska "sisäisillä sivustoillamme" arvataan usein tarkoitettua suppeammaksi.
• Sinun tapauksesi on kolmas: taustalla toimiva tarkkailija, jonka tila säilyy riippumatta siitä, onko välilehti auki, ja joka toimii MV3:n mukaisessa service workerissa merkiten kuvakkeen, kun jokin muuttuu.

Tämä on se ainoa rakenne, jossa rakentajan pitäisi esittää sinulle tarkentava kysymys — ja se esittääkin, koska pollausväli on todellinen kompromissi, ei muodollisuus.

Mikä palauttaa minut "joka minuutti" -vaistoosi. Pyysin itse aikoinaan lähes tasan samanlaisen rakennelman — seuraa sivua, merkitse kuvake hinnanmuutoksesta — ja ensimmäinen versio pollasi 60 sekunnin välein. Toimi hyvin yhdelle henkilölle paikallisessa testauksessa. Kerro se sillä, kuinka moni oikeasti asentaa tämän, ja hakkaat jonkun tuotesivua ilman syytä, sillä tavallisen vähittäiskaupan listauksen hinnat eivät muutu useammin kuin muutaman kerran päivässä. Kirjoita kehotteeseen "tarkista 30 minuutin välein". Se ei ole kompromissi, vaan rehellisempi pyyntö — kukaan ei tarvitse alle minuutin hälytyksiä selainlaajennukselta, ja kiität itseäsi myöhemmin, kun sinun ei tarvitse selittää arvioijalle, miksi laajennuksesi ottaa yhteyttä 1 440 kertaa päivässä.

Osat, joita sinun ei tarvitse miettiä

Mainitsit olevasi hermostunut manifestin suhteen — älä ole, se on juuri se asia, johon sinun ei aidosti tarvitse koskea. Molemmat kaupat vaativat nyt Manifest V3:n; MV2:ta ei enää hyväksytä uusiin listauksiin, ja Chrome on aktiivisesti ajamassa alas yhä käytössä olevia MV2-laajennuksia. MV3:n päämuutos on se, että taustalogiikkasi toimii service workerina eikä pysyvänä taustasivuna — se käynnistyy tapahtumasta, selain voi sammuttaa sen tapahtumien välillä, ja tila on kuljetettava chrome.storage eikä vain säilytettävä muuttujassa. Se on juuri sellainen elinkaaridetalji, jonka rakentaja kirjoittaa oletuksena oikein. Et koskaan näe manifestitiedostoa, ellet erikseen mene etsimään sitä.

Se, mihin sinun kannattaa oikeasti käyttää huomiotasi, on käyttöoikeudet, sillä ne ratkaisevat arviointisi nopeuden — ei koodi. Seurantalaajennuksesi tarvitsee alarms pollausta varten ja luultavasti storage viimeisimmän hinnan muistamista varten — se ei tarvitse tabs tai <all_urls>, ja jos pyydät "mahdollisuutta toimia millä tahansa sivustolla myöhemmin" siltä varalta, että laajennat sitä myöhemmin, rakentaja rakentaa sen mukaisesti, ja pyydät laajaa sivustooikeutta ominaisuudelle, jota ei vielä ole olemassa. Se on pelottavin rivi asennusikkunassa — "lukee ja muuttaa tietoja jokaisella käymälläsi sivustolla" — ja se on myös asia, joka siirtää automaattisen arvioinnin manuaaliseksi. Kuvaile, mitä laajennus tekee tänään. Laajenna myöhemmin, jos oikeasti tarvitset.

Vielä kaksi asiaa, joihin kannattaa käyttää puoli minuuttia ennen kuin julistat tämän valmiiksi: ponnahdusikkunan käyttöliittymä ja kuvakkeet.

• Ponnahdusikkunan käyttöliittymä — oletusasetussivu, paljaat valintaruudut ilman hierarkiaa, on todellinen syy yhden tähden arvosteluille, jotka eivät liity mitenkään siihen, toimiiko laajennus. Sinulla on vain muutama asetus (URL, ehkä aikaväli), mutta sen pitäisi silti näyttää siltä, että se kuuluu tuotteeseen, ei lomakekaatopaikalta.
• Kuvakkeet — tarkista kuvake kaikissa neljässä Chrome-koossa (16, 32, 48, 128 px, Firefoxissa hieman eri kokovalikoima), sillä logo, joka on terävä koossa 128, muuttuu tahraksi koossa 16 — ja juuri siellä se elää suurimman osan ajasta täydessä työkalurivissä.

Ennen kuin koskaan kauppoihin

Testaa tämä oikeasti, ei vain chatin esikatselussa. Rakennuksesta saat oikean, ladattavan laajennuksen, joten mene chrome://extensions, kytke kehittäjätila päälle, valitse "lataa pakkaamaton" ja aja se oikeaa tuotesivua vastaan, josta olet kiinnostunut — ei simuloitua versiota siitä. Tarkistaisin erityisesti kaksi asiaa käsin: sanooko asennuksen käyttöoikeuskehote sitä, mitä odottaisit pyytämäsi perusteella, ja mitä tapahtuu, jos sisältöskripti joskus osuu sivulle, jota varten sitä ei rakennettu — epäonnistuuko se hiljaisesti vai heittääkö se näkyvän virheen? Molemmat vievät alle minuutin ja molemmat ovat sellaisia bugeja, jotka ovat ilmiselviä heti kun katsoo, ja näkymättömiä, jos ei katso.

Kun olet valmis todella julkaisemaan, käyt läpi omat kehittäjätilisi molemmissa kaupoissa — omistat listauksen, tämä alusta ei hallinnoi sitä puolestasi. Ja haluan huomauttaa, että kaupat eivät ole lainkaan symmetrisiä keskenään, sillä en halua sinun suunnittelevan julkaisupäivää siinä oletuksessa, että ne olisivat.

Rakennuksen valmistuttua generoituva listauspaketti tuottaa myös kuvakaappauksia oikeasti käynnissä olevasta laajennuksestasi (ei mallikuvista), listaustekstit ja tietosuojakäytäntövastaukset, jotka on tarkistettu oikeaa koodia vasten eikä täytetty muistin varassa. Tuo viimeinen kohta on tärkeämpi kuin miltä kuulostaa, kun kyse on jostakin, joka on yhteydessä ulkoiseen sivuun: Chromen tietosuojakyselyssä on suoria kyllä/ei-kysymyksiä tietojen käsittelystä, ja "ei" vastaaminen kysymykseen "kerääkö tämä tietoja", kun seurantalaajennuksesi pollaa ja tallentaa hintoja, on sellainen pieni epärehellisyys, joka johtaa poistoon julkaisun jälkeen, ei vain hylkäykseen ennen sitä. Kun vastaukset tarkistetaan koodin todellista toimintaa vasten, tämä aukko sulkeutuu puolestasi automaattisesti.

Vielä yksi asia, koska tunnen sinut — mietit jo "synkronoi seurantalistani laitteiden välillä" ja "seuraa hintahistoriaa ajan mittaan" -ominaisuuksien lisäämistä julkaisun jälkeen. Se on ihan hyvä, mutta muista, että jokainen niistä on uusi käyttöoikeus, ja uusi käyttöoikeus voi tarkoittaa hitaampaa arviointia kuin se, jonka juuri läpäisit. Jos olet varma, että haluat suuremman version, on aidosti parempi kehottaa sitä nyt ja hyväksyä yksi hitaampi arviointi kuin lisätä käyttöoikeuksia yksitellen. Jos et ole vielä varma, julkaise se, mitä sinulla on — tarkkaan rajattu seurantalaajennus etenee nopeasti, tuo oikeaa käyttöä, ja oikea käyttö on juuri nyt arvokkaampaa kuin pidempi ominaisuuslista Chromen jonossa odottamassa. Voit aina pyytää lisää myöhemmin; et voi saada tätä julkaisua takaisin, jos se jumittuu manuaaliseen arviointiin jonkin sellaisen takia, jota et vielä tarvinnut.