Chuyển đến nội dung
FrAIFlow

Giải pháp / Văn bản & Mã

Vì sao dấu đô la làm thay đổi văn bản thay thế trong JavaScript?

Công cụ tìm-thay thế lại thay đổi chính văn bản thay thế. Ngay cả khi tìm bằng chuỗi thông thường, JavaScript vẫn diễn giải các chuỗi bắt đầu bằng đô la trong đối số thay thế. Nếu người dùng muốn văn bản nguyên văn, hãy trả văn bản đó từ một hàm.

Một giá trị, hai cách diễn giải
Hình giải thích do tác giả tạo dựa trên ví dụ được lưu lại; không phải ảnh chụp ứng dụng.

Nhận diện mẫu thay thế trước khi sửa đầu vào

Giả sử bạn thay một đoạn văn bản mẫu bằng phần giải thích giá có chứa $&. Người dùng muốn đúng hai ký tự đó nhưng chỗ giữ chỗ cũ lại xuất hiện. Đây không nhất thiết là lỗi bảng mã. Đối số thay thế có ngôn ngữ mẫu nhỏ riêng, ngay cả khi tìm bằng chuỗi thuần chứ không dùng biểu thức chính quy.

Bắt đầu với bản sao văn bản và một vị trí khớp. Nếu chuỗi đô la thay đổi, chuyển đối số thay thế sang callback rồi đối chiếu kết quả. Giữ nguyên nội dung tìm trong phép so sánh này. Đổi cả hai đầu vào cùng lúc sẽ khó biết quy tắc nào gây bất ngờ.

Một báo cáo công khai năm 2012 thay toàn bộ chuỗi bằng $' và nhận kết quả rỗng. Token đó chỉ phần hậu tố sau vùng khớp. Vì vùng khớp chiếm toàn bộ, không còn hậu tố.

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

Thử nghiệm Node.js v24.19.0 được lưu tái hiện cả hai kết quả. Các token thay thế khác gồm $$ cho dấu đô la, $& cho phần khớp và tham chiếu nhóm như $1 khi mẫu có nhóm tương ứng. Còn có dạng tiền tố và nhóm có tên. Không phải dấu đô la đứng riêng nào cũng đặc biệt.

Phân biệt rõ hai chế độ
Hình giải thích do tác giả tạo dựa trên ví dụ được lưu lại; không phải ảnh chụp ứng dụng.

Dùng callback khi người dùng muốn văn bản nguyên văn

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

Lần gọi đầu diễn giải chuỗi thay thế. Lần thứ hai, hàm trả nguyên giá trị người dùng cho mỗi vị trí khớp. Giá trị trả về được chèn mà không qua thêm lượt diễn giải mẫu. Điều này hữu ích cho công cụ hứa tìm-thay thế thông thường, nơi người dùng không cần học cách thoát đô la chỉ để dán văn bản.

Đừng giải quyết bằng cách tự động dựng biểu thức chính quy từ nội dung tìm của người dùng. Trong chế độ nguyên văn, chuỗi tìm như a.b thường phải tìm dấu chấm thật, không phải mọi ký tự. Nếu có hỗ trợ nhóm regex và mẫu thay thế, giữ chế độ nâng cao riêng với nhãn rõ. Mẫu như $1 hữu ích trong chế độ đó và không nên bất ngờ trở thành nguyên văn mà không giải thích.

Thay bằng chuỗi diễn giải token đô la; callback giữ chính xác văn bản đô la đã nhập.
Hình giải thích trước-sau tự tạo của chính ví dụ Node.js tổng hợp trên. Không phải ảnh chụp trình soạn thảo. Mở ảnh để xem đầy đủ chi tiết.
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);
}

Các hàm này nhận chuỗi do ứng dụng cung cấp. Một hàm thay lần xuất hiện đầu, hàm kia thay mọi lần khớp. Chỉ replaceLiteralAll từ chối chuỗi tìm rỗng để tránh chèn giữa các đơn vị mã. Khi chuỗi tìm rỗng, replaceLiteralOnce chèn nội dung thay thế vào đầu chuỗi. Nếu sản phẩm chủ ý hỗ trợ mẫu nhóm bắt, giữ chế độ đó và ghi rõ thay vì âm thầm đổi ý nghĩa.

Xem trước toàn bộ thay đổi trong ngữ cảnh cuối

Hiển thị cả văn bản gốc và mới, đặc biệt với Thay tất cả. Thử nội dung thay thế có một dấu đô la, hai dấu đô la, token vùng khớp và chuỗi rỗng. Kiểm tra khi không có vị trí khớp. Thay bằng rỗng là xóa hợp lệ; tìm chuỗi rỗng cần quyết định rõ của sản phẩm vì có thể chèn giữa các vị trí khắp chuỗi.

Cuối cùng, kiểm tra cách hiển thị kết quả. Trả văn bản nguyên văn từ callback không làm HTML an toàn. Bản xem trước nên dùng textarea hoặc textContent cho văn bản không đáng tin để thẻ được dán hiển thị chứ không thực thi. Chỉ lưu hoặc gửi khi bản xem trước khớp ý định người dùng và giữ cách hoàn tác khi sửa hàng loạt.

Các mẫu đã ghi giữ chính xác $&, $', $$ và $1 khi callback trả chúng. Thêm ví dụ tương tự vào thử nghiệm chống hồi quy, gồm khớp nhiều lần và thay bằng rỗng. Giữ nguồn; xem trước sửa hàng loạt.

Kết quả đo: đối số chuỗi tạo đầu ra rỗng; hàm trả đúng dấu đô la và nháy đơn.
Hình giải thích gốc được giữ lại.
Kết quả thử nghiệm tổng hợp đã ghi cho việc dấu đô la thay đổi văn bản thay thế JavaScript
Đầu ra thay thế chuỗi Node.js đã ghi với văn bản đô la nguyên văn. Đây là ảnh chụp kết quả thử nghiệm, không phải ứng dụng người báo lỗi ban đầu. Mở ảnh bằng chứng đầy đủ kích thước.

Nguồn và bài đọc liên quan