Lewati ke konten
FrAIFlow

Solusi / Peramban & Perangkat

Tombol Salin berfungsi di localhost tetapi gagal di situs Anda

Tombol Salin berfungsi di localhost, lalu gagal di situs yang sudah diterapkan. Cari tahu dahulu apakah Clipboard API tidak tersedia atau permintaan penulisannya ditolak. Kedua kegagalan itu memerlukan perbaikan berbeda.

Temukan batas tempat kegagalan terjadi
Ilustrasi buatan penulis berdasarkan contoh yang dipertahankan; bukan tangkapan layar aplikasi.

Ambil teks tanpa melemahkan keamanan peramban

Jika hanya perlu menyalin hasil, klik teks yang terlihat, pilih, lalu gunakan perintah Salin pada sistem operasi. Di ponsel, sentuh dan tahan teks untuk memunculkan penanda seleksi. Jika halaman menyembunyikan hasil di balik tombol Salin yang rusak, pemilik situs perlu memperbaiki masalah kegunaan tersebut. Jangan memasang ekstensi atau menonaktifkan batasan keamanan hanya untuk menyalin teks pendek.

Bagi pemilik situs, reproduksi masalah pada halaman yang sudah diterapkan. Periksa bahwa alamatnya diawali HTTPS, halaman sedang fokus, dan apakah halaman disematkan di situs lain. Tombol localhost yang berfungsi berguna selama pengembangan, tetapi bukan bukti bahwa origin produksi memiliki izin yang sama.

Periksa halaman yang diterapkan, bukan hanya localhost

Laporan publik tahun 2018 mengonfirmasi bahwa HTTPS memulihkan objek clipboard yang tidak tersedia. Localhost dapat menyembunyikan masalah karena HTTP loopback mungkin dianggap tepercaya. Pengecualian itu tidak membuat situs HTTP biasa menjadi aman.

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

Pengujian Chromium terisolasi yang dipertahankan membandingkan HTTP loopback dengan hostname uji yang dipetakan ke loopback. Pengujian ini hanya mengukur ketersediaan API. Tidak ada isi clipboard yang dibaca atau ditulis dan tidak ada izin yang diberikan. Jika halaman produksi tidak aman, perbaiki penyajian HTTPS, bukan meminta pengunjung menonaktifkan kontrol keamanan.

Pertahankan tindakan bersama klik
Ilustrasi buatan penulis berdasarkan contoh yang dipertahankan; bukan tangkapan layar aplikasi.

Mulai penulisan clipboard di dalam klik

HTTPS saja tidak menjamin izin. Laporan WebKit menunjukkan penulisan Safari gagal setelah penangan klik menunggu fetch. Contoh perbaikannya memulai penulisan saat klik dan menyediakan data ClipboardItem berupa promise. Ini bukan bukti bahwa seluruh pekerjaan asinkron gagal pada semua peramban.

Contoh minimal ini menjaga teks tetap terlihat, memulai penulisan clipboard langsung dari klik nyata, dan menampilkan petunjuk penyalinan manual jika permintaan gagal. Simpan sebagai halaman uji yang disajikan dari origin aman yang diizinkan. Contoh ini tidak meminta pembacaan clipboard atau mengirim teks ke mana pun. Ganti nilai contoh textarea dengan hasil yang sudah disiapkan aplikasi Anda.

<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>

Ini panduan implementasi, bukan klaim pengujian lintas peramban baru. Jika hasil memerlukan permintaan jaringan, selesaikan permintaan itu sebelum mengaktifkan Salin. Jangan memberi tahu pengguna bahwa penyalinan berhasil hanya karena penangan klik berjalan. Contoh ini baru menyatakan berhasil setelah promise penulisan terselesaikan.

Verifikasi penyalinan dan pertahankan pilihan manual

Gunakan contoh pendek tanpa informasi sensitif, dengan baris baru dan karakter beraksen. Klik Salin, lalu tempel ke editor teks biasa dan bandingkan seluruh nilainya. Uji juga pilihan manual. Jika penyalinan otomatis hanya gagal dalam frame sematan, bandingkan halaman tingkat atas dengan versi sematan dan periksa kebijakan penyematan bersama pemilik situs. Jangan menganggap dialog izin atau pengaturan peramban berperilaku sama di semua mesin.

Pahami batas pengujian origin tercatat di bawah: pengujian itu memastikan apakah API tersedia, bukan apakah tombol ini dapat menulis pada setiap peramban. Tujuan praktisnya dua jalur yang dapat digunakan: penyalinan berhasil ketika diizinkan, serta hasil yang terlihat dan dapat dipilih ketika tidak diizinkan.

Jaga teks tetap terlihat dan dapat dipilih. Halaman sematan mungkin dibatasi oleh Permissions Policy induknya; fokus dokumen, pengaturan peramban, dan aturan platform juga berpengaruh. Nama izin clipboard dan perilakunya berbeda antarperamban. Periksa dokumentasi peramban terkait, bukan menganggap satu hasil Chromium sebagai jaminan untuk Safari atau Firefox.

Pengukuran: HTTP loopback menyediakan Clipboard API; hostname uji HTTP biasa tidak.
Penjelasan asli yang dipertahankan.
Keluaran uji sintetis tercatat untuk tombol Salin yang berfungsi di localhost tetapi gagal di situs
Pemeriksaan origin dan ketersediaan API Chromium terisolasi yang tercatat. Tidak ada isi clipboard yang dibaca atau ditulis. Ini tangkapan keluaran pengujian tercatat, bukan aplikasi pelapor aslinya. Buka gambar bukti ukuran penuh.

Sumber dan bacaan terkait