String.prototype.replaceAll()

Try it

const paragraph = "I think Ruth's dog is cuter than your dog!";

console.log(paragraph.replaceAll("dog", "monkey"));
// Expected output: "I think Ruth's monkey is cuter than your monkey!"

// Global flag required when calling replaceAll with regex
const regex = /dog/gi;
console.log(paragraph.replaceAll(regex, "ferret"));
// Expected output: "I think Ruth's ferret is cuter than your ferret!"

Cú pháp

replaceAll(pattern, replacement)

Tham số

pattern

Có thể là một chuỗi hoặc một đối tượng có phương thức Symbol.replace — ví dụ điển hình là một biểu thức chính quy. Bất kỳ giá trị nào không có phương thức Symbol.replace sẽ bị ép kiểu thành chuỗi.

Nếu pattern là một regex, thì regex đó phải có cờ global (g) được đặt, nếu không sẽ ném ra lỗi TypeError.

replacement

Có thể là một chuỗi hoặc một hàm. Replacement có cùng ngữ nghĩa với String.prototype.replace().

Giá trị trả về

Một chuỗi mới, với tất cả các kết quả khớp của pattern được thay thế bởi replacement.

Ngoại lệ

TypeError

Được ném ra nếu pattern là một regex không có cờ global (g) được đặt (thuộc tính flags của nó không chứa "g").

Mô tả

Phương thức này không thay đổi giá trị chuỗi được gọi trên đó. Nó trả về một chuỗi mới.

Khác với replace(), phương thức này thay thế tất cả các lần xuất hiện của một chuỗi, không chỉ lần đầu tiên. Mặc dù cũng có thể dùng replace() với một regex global được xây dựng động bằng RegExp() để thay thế tất cả các lần xuất hiện của một chuỗi, điều này có thể gây ra hậu quả không mong muốn nếu chuỗi chứa các ký tự đặc biệt có ý nghĩa trong biểu thức chính quy (điều này có thể xảy ra nếu chuỗi thay thế đến từ đầu vào của người dùng). Mặc dù bạn có thể giảm thiểu trường hợp này bằng RegExp.escape() để chuyển chuỗi biểu thức chính quy thành một mẫu ký tự, nhưng đơn giản hơn là truyền chuỗi trực tiếp vào replaceAll() mà không cần chuyển đổi thành regex.

function unsafeRedactName(text, name) {
  return text.replace(new RegExp(name, "g"), "[REDACTED]");
}
function semiSafeRedactName(text, name) {
  return text.replaceAll(name, "[REDACTED]");
}
function superSafeRedactName(text, name) {
  // only match at word boundaries
  return text.replaceAll(
    new RegExp(`\\b${RegExp.escape(name)}\\b`, "g"),
    "[REDACTED]",
  );
}

let report =
  "A hacker called ha.*er used special characters in their name to breach the system.";

console.log(unsafeRedactName(report, "ha.*er")); // "A [REDACTED]s in their name to breach the system."
console.log(semiSafeRedactName(report, "ha.*er")); // "A hacker called [REDACTED] used special characters in their name to breach the system."

report = "A hacker called acke breached the system.";

console.log(semiSafeRedactName(report, "acke")); // "A h[REDACTED]r called [REDACTED] breached the system."
console.log(superSafeRedactName(report, "acke")); // "A hacker called [REDACTED] breached the system."

Nếu pattern là một đối tượng có phương thức Symbol.replace (bao gồm các đối tượng RegExp), phương thức đó được gọi với chuỗi đích và replacement làm đối số. Giá trị trả về của nó trở thành giá trị trả về của replaceAll(). Trong trường hợp này, hành vi của replaceAll() được mã hóa hoàn toàn bởi phương thức [Symbol.replace](), do đó sẽ cho kết quả giống với replace() (ngoại trừ việc kiểm tra đầu vào thêm rằng regex phải là global).

Nếu pattern là một chuỗi rỗng, replacement sẽ được chèn vào giữa mỗi đơn vị mã UTF-16, tương tự như hành vi của split().

"xxx".replaceAll("", "_"); // "_x_x_x_"

Để biết thêm thông tin về cách các thuộc tính regex (đặc biệt là cờ sticky) tương tác với replaceAll(), xem RegExp.prototype[Symbol.replace]().

Ví dụ

Sử dụng replaceAll()

"aabbcc".replaceAll("b", ".");
// 'aa..cc'

Regex không global sẽ ném lỗi

Khi dùng giá trị tìm kiếm là biểu thức chính quy, nó phải là global. Cách này sẽ không hoạt động:

"aabbcc".replaceAll(/b/, ".");
// TypeError: replaceAll must be called with a global RegExp

Cách này sẽ hoạt động:

"aabbcc".replaceAll(/b/g, ".");
("aa..cc");

Thông số kỹ thuật

Khả năng tương thích trình duyệt

Xem thêm

• Polyfill của String.prototype.replaceAll trong core-js
• Polyfill es-shims của String.prototype.replaceAll
• Hướng dẫn Biểu thức chính quy
• String.prototype.replace()
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype.test()