Lewati ke konten
FrAIFlow

Solusi / Teks & Kode

Mengapa tanda dolar mengubah teks pengganti JavaScript

Alat cari-dan-ganti mengubah teks penggantinya sendiri. Bahkan dengan pencarian string biasa, JavaScript menafsirkan urutan dolar dalam argumen pengganti. Jika pengguna menghendaki teks literal, kembalikan teks itu melalui fungsi.

Satu nilai, dua penafsiran
Ilustrasi buatan penulis berdasarkan contoh yang dipertahankan; bukan tangkapan layar aplikasi.

Kenali templat penggantian sebelum mengubah masukan

Bayangkan mengganti placeholder dengan penjelasan harga yang memuat $&. Pengguna mengharapkan kedua karakter itu, tetapi placeholder lama muncul kembali. Ini belum tentu masalah pengodean. Argumen pengganti memiliki bahasa templat kecilnya sendiri, bahkan ketika pencarian berupa string biasa, bukan ekspresi reguler.

Mulai dengan salinan teks dan satu kecocokan. Jika urutan dolar berubah, ganti argumen pengganti menjadi callback dan bandingkan hasilnya. Pertahankan pencarian yang sama untuk perbandingan ini. Mengubah kedua masukan sekaligus membuat penyebabnya lebih sulit diketahui.

Laporan publik tahun 2012 mengganti seluruh string dengan $' dan memperoleh hasil kosong. Token itu berarti akhiran setelah kecocokan. Karena kecocokan mencakup semuanya, tidak ada akhiran.

const input = "as";
const replacement = "$'";
input.replace("as", replacement);       // ""
input.replace("as", () => replacement); // "$'"

Pengujian Node.js v24.19.0 yang dipertahankan mereproduksi kedua hasil. Token pengganti lain meliputi $$ untuk tanda dolar, $& untuk kecocokan, serta referensi tangkapan seperti $1 ketika pola memiliki grup terkait. Ada pula bentuk awalan dan tangkapan bernama. Tidak setiap tanda dolar berdiri sendiri bersifat khusus.

Bedakan kedua mode secara eksplisit
Ilustrasi buatan penulis berdasarkan contoh yang dipertahankan; bukan tangkapan layar aplikasi.

Gunakan callback jika pengguna menginginkan teks literal

const draft = "Price: TOKEN. Repeat: TOKEN.";
const typedReplacement = "$& costs $$";

console.log(draft.replaceAll("TOKEN", typedReplacement));
// Price: TOKEN costs $. Repeat: TOKEN costs $.

console.log(draft.replaceAll("TOKEN", () => typedReplacement));
// Price: $& costs $$. Repeat: $& costs $$.

Pada panggilan pertama, string pengganti ditafsirkan. Pada yang kedua, fungsi mengembalikan nilai literal pengguna untuk setiap kecocokan. Nilai balik itu disisipkan tanpa melewati penafsiran templat pengganti lagi. Ini berguna untuk alat yang menjanjikan cari-dan-ganti biasa, sehingga pengguna tidak perlu mempelajari escaping dolar khusus hanya untuk menempel teks.

Jangan mengatasinya dengan otomatis membuat ekspresi reguler dari pencarian pengguna. Pencarian seperti a.b biasanya harus menemukan titik literal dalam mode literal, bukan sembarang karakter. Pertahankan mode lanjutan terpisah dengan label jelas jika Anda juga menyediakan tangkapan regex dan templat pengganti. Templat seperti $1 berguna dalam mode itu dan tidak seharusnya tiba-tiba menjadi literal tanpa penjelasan.

Penggantian string menafsirkan token dolar; callback mempertahankan teks dolar yang dimasukkan secara persis.
Penjelasan sebelum-sesudah buatan penulis tentang contoh Node.js sintetis persis di atas. Bukan tangkapan layar editor teks. Buka gambar untuk detail ukuran penuh.
function replaceLiteralOnce(text, search, value) {
  return text.replace(search, () => value);
}
function replaceLiteralAll(text, search, value) {
  if (search === "") throw new Error("Search must not be empty");
  return text.replaceAll(search, () => value);
}

Fungsi bantu ini mengharapkan string yang disediakan aplikasi. Satu mengganti kemunculan pertama; lainnya mengganti semua kemunculan yang cocok. Hanya replaceLiteralAll yang menolak pencarian kosong untuk mencegah penyisipan di antara unit kode. Jika pencarian kosong, replaceLiteralOnce menyisipkan teks pengganti di awal string. Jika produk sengaja mendukung templat tangkapan, pertahankan mode itu dan beri label jelas, bukan diam-diam mengubah maknanya.

Pratinjau seluruh penyuntingan dalam konteks akhirnya

Tampilkan teks asli dan hasil perubahan, terutama untuk Ganti semua. Uji pengganti yang berisi satu dolar, dua dolar, token kecocokan, dan string kosong. Verifikasi perilaku saat tidak ada kecocokan. Pengganti kosong adalah penghapusan yang sah; pencarian kosong memerlukan keputusan produk eksplisit karena bisa menyisipkan teks di antara posisi sepanjang string.

Terakhir, periksa cara hasil ditampilkan. Mengembalikan teks literal dari callback pengganti tidak membuat HTML aman. Pratinjau harus memakai textarea atau textContent untuk teks tidak tepercaya, agar tag tempelan ditampilkan, bukan dijalankan. Simpan atau kirim hanya setelah pratinjau sesuai maksud pengguna, dan pertahankan cara membatalkan penyuntingan massal.

Contoh uji tercatat mempertahankan $&, $', $$ dan $1 secara persis ketika dikembalikan callback. Tambahkan contoh serupa ke pengujian nonregresi Anda, termasuk kecocokan berulang dan pengganti kosong. Pertahankan sumber; pratinjau penyuntingan massal.

Penggantian terukur: argumen string menghasilkan keluaran kosong; fungsi mengembalikan dolar dan apostrof literal.
Penjelasan asli yang dipertahankan.
Keluaran uji sintetis tercatat untuk alasan tanda dolar mengubah teks pengganti JavaScript
Keluaran penggantian string Node.js tercatat dengan teks tanda dolar literal. Ini tangkapan keluaran pengujian tercatat, bukan aplikasi pelapor aslinya. Buka gambar bukti ukuran penuh.

Sumber dan bacaan terkait