Siirry sisältöön
FrAIFlow

Ratkaisut / Selain & laitteet

Kopiointi toimii localhostissa mutta ei verkkosivustolla

Kopioi-painike toimii localhostissa mutta ei julkaistulla sivustolla. Selvitä ensin, puuttuuko Clipboard API kokonaan vai hylätäänkö kirjoituspyyntö. Nämä viat korjataan eri tavoin.

Paikanna epäonnistuva muunnosraja
Tekijän laatima, säilytettyyn esimerkkiin perustuva havainnekuva; ei sovelluksen kuvakaappaus.

Kopioi teksti heikentämättä selaimen suojausta

Jos haluat vain kopioida tuloksen, napsauta näkyvää tekstiä, valitse se ja käytä käyttöjärjestelmän Kopioi-toimintoa. Puhelimessa paina tekstiä pitkään, jotta valintakahvat tulevat näkyviin. Jos tulos on piilossa rikkinäisen Kopioi-painikkeen takana, sivuston omistajan on korjattava käytettävyysongelma. Älä asenna laajennusta tai poista suojauksia vain lyhyen tekstin kopioimiseksi.

Sivuston ylläpitäjän kannattaa toistaa ongelma julkaistulla sivulla. Tarkista HTTPS-osoite, sivun aktiivisuus ja se, onko sivu upotettu toiselle sivustolle. Toimiva localhost-painike auttaa kehityksessä, mutta ei todista, että julkaistun alkuperän käyttöoikeudet ovat samat.

Tarkista julkaistu sivu, älä vain localhostia

Vuoden 2018 julkisessa tapauksessa HTTPS palautti puuttuvan clipboard-objektin käyttöön. Localhost voi peittää ongelman, koska silmukkaosoitteen HTTP-yhteys voidaan tulkita luotettavaksi. Poikkeus ei tee tavallisesta HTTP-sivustosta turvallista.

console.table({
  secure: window.isSecureContext,
  exposed: Boolean(navigator.clipboard),
  active: navigator.userActivation?.isActive
});

Säilytetyssä eristetyssä Chromium-testissä verrattiin silmukkaosoitteen HTTP:tä samaan osoitteeseen ohjattuun testipalvelinnimeen. Mitattiin vain API:n saatavuutta. Leikepöytää ei luettu eikä siihen kirjoitettu, eikä käyttöoikeutta myönnetty. Korjaa turvattoman julkaisusivun HTTPS sen sijaan, että pyytäisit kävijöitä poistamaan suojauksia.

Pidä toiminto napsautuksen yhteydessä
Tekijän laatima, säilytettyyn esimerkkiin perustuva havainnekuva; ei sovelluksen kuvakaappaus.

Käynnistä leikepöydälle kirjoittaminen napsautuksen yhteydessä

HTTPS ei yksin takaa käyttöoikeutta. WebKit-raportissa Safarin kirjoitus epäonnistui, kun napsautuskäsittelijä oli odottanut fetch-pyyntöä. Korjattu esimerkki käynnisti kirjoituksen napsautuksen aikana ja toimitti ClipboardItem-tiedot promise-muodossa. Tämä ei osoita kaiken asynkronisen toiminnan epäonnistuvan kaikissa selaimissa.

Minimiesimerkki pitää tekstin näkyvillä, aloittaa kirjoituksen suoraan aidosta napsautuksesta ja näyttää manuaalisen kopiointiohjeen pyynnön epäonnistuessa. Tallenna se sallitusta turvallisesta alkuperästä tarjottavaksi testisivuksi. Se ei pyydä leikepöydän lukemista eikä lähetä tekstiä minnekään. Korvaa tekstialueen esimerkki sovelluksesi valmiiksi muodostetulla tuloksella.

<textarea id="copy-source" readonly aria-label="Text to copy">Your finished result</textarea>
<button id="copy-button" type="button">Copy result</button>
<p id="copy-status" role="status"></p>
<script>
const source = document.getElementById("copy-source");
const status = document.getElementById("copy-status");
document.getElementById("copy-button").addEventListener("click", async () => {
  try {
    if (!window.isSecureContext || !navigator.clipboard) {
      throw new Error("Clipboard unavailable");
    }
    await navigator.clipboard.writeText(source.value);
    status.textContent = "Copied. Paste it where you need it.";
  } catch {
    source.focus();
    source.select();
    status.textContent = "Automatic copy failed. Use your device's Copy command on the selected text.";
  }
});
</script>

Tämä on toteutusohje, ei väite uudesta selainten välisestä testistä. Jos tulos vaatii verkkopyynnön, suorita pyyntö ennen Kopioi-painikkeen käyttöönottoa. Älä ilmoita onnistumisesta pelkästään siksi, että napsautuskäsittelijä suoritettiin. Tässä esimerkissä onnistuminen ilmoitetaan vasta kirjoitus-promisen toteuduttua.

Tarkista kopiointi ja säilytä manuaalinen vaihtoehto

Kokeile lyhyttä, ei-arkaluonteista tekstiä, jossa on rivinvaihto ja aksentillinen merkki. Paina Kopioi, liitä pelkkää tekstiä käsittelevään editoriin ja vertaa koko sisältöä. Kokeile myös manuaalista vaihtoehtoa. Jos automaattinen kopiointi epäonnistuu vain kehyksessä, vertaa itsenäistä ja upotettua sivua ja tarkista upotuskäytäntö sivuston ylläpitäjän kanssa. Käyttöoikeusikkuna tai selainasetus ei välttämättä toimi samalla tavalla eri selainmoottoreissa.

Alla tallennettu alkuperätesti osoitti vain API:n saatavuuden, ei tämän painikkeen kirjoitusoikeutta jokaisessa selaimessa. Käytännön tavoite on kaksi toimivaa vaihtoehtoa: sallittu automaattinen kopiointi sekä näkyvä, valittava tulos silloin, kun kopiointia ei sallita.

Pidä teksti näkyvillä ja valittavissa. Upotettua sivua voi rajoittaa isäntäsivun Permissions Policy; myös kohdistus, selainasetukset ja alustan säännöt vaikuttavat. Leikepöytäoikeuksien nimet ja toiminta vaihtelevat selaimittain. Tarkista kyseisen selaimen dokumentaatio äläkä pidä Chromium-tulosta takeena Safarille tai Firefoxille.

Mitatussa testissä silmukkaosoitteen HTTP tarjosi Clipboard API:n, tavallinen HTTP-testipalvelinnimi ei.
Säilytetty alkuperäinen selitys.
Synteettisen testin tallennettu tulos: kopiointi toimii localhostissa mutta ei verkkosivustolla
Tallennetut eristetyt Chromiumin alkuperä- ja API-saatavuustarkistukset. Leikepöytää ei luettu eikä siihen kirjoitettu. Kuva esittää tallennettua testitulosta, ei alkuperäisen ilmoittajan sovellusta. Avaa täysikokoinen testikuva.

Lähteet ja lisälukeminen