JavaScript 바꾸기에서 달러 기호가 다른 내용으로 변하는 이유
찾아 바꾸기 도구가 바꿀 텍스트 자체를 바꿉니다. 검색값이 일반 문자열이어도 JavaScript는 치환 인수의 달러 기호 조합을 해석합니다. 사용자가 문자 그대로 넣으려는 경우에는 함수에서 그 텍스트를 반환하세요.
입력을 고치기 전에 치환 템플릿인지 확인하세요
자리표시자를 $&가 든 가격 설명으로 바꾼다고 해 보겠습니다. 사용자는 두 문자를 기대하지만 이전 자리표시자가 다시 나타납니다. 반드시 인코딩 문제가 있는 것은 아닙니다. 검색이 정규식이 아니라 일반 문자열이어도 치환 인수에는 작은 템플릿 문법이 있습니다.
텍스트 복사본과 일치 한 개로 시작하세요. 달러 조합이 달라지면 치환 인수를 콜백으로 바꾸고 결과를 비교합니다. 이 비교에서는 검색값은 그대로 두세요. 둘을 동시에 바꾸면 어떤 규칙 때문에 달라졌는지 찾기 어렵습니다.
2012년 공개 사례에서는 전체 문자열을 $'로 바꿨더니 빈 결과가 나왔습니다. 그 토큰은 일치 뒤의 접미 부분을 뜻합니다. 일치가 전체를 차지했으므로 남은 접미 부분이 없었던 것입니다.
const input = "as";
const replacement = "$'";
input.replace("as", replacement); // ""
input.replace("as", () => replacement); // "$'"
보존된 Node.js v24.19.0 시험은 두 결과를 모두 재현했습니다. 다른 치환 토큰에는 달러 하나를 뜻하는 $$, 일치 부분인 $&, 관련 그룹이 있을 때의 $1 같은 캡처 참조가 있습니다. 접두 부분과 이름 있는 캡처 형식도 있습니다. 달러 하나가 언제나 특별한 것은 아닙니다.
문자 그대로 바꾸려면 콜백을 사용하세요
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 $$.
첫 호출은 치환 문자열을 해석합니다. 두 번째는 함수가 각 일치에 대해 사용자가 입력한 값을 그대로 반환합니다. 그 반환값에는 치환 템플릿 해석을 다시 하지 않습니다. 일반적인 찾아 바꾸기를 약속하는 도구에서 유용합니다. 텍스트를 붙이려고 사용자가 특수한 달러 이스케이프를 배울 필요가 없어야 합니다.
사용자 검색값으로 정규식을 자동 생성하는 방식으로 해결하지 마세요. 일반 검색 모드에서 a.b는 대개 임의의 한 문자가 아니라 실제 마침표를 찾아야 합니다. 정규식 캡처와 치환 템플릿을 제공한다면 명확히 표시한 별도 고급 모드를 두세요. 그 모드에서 유용한 $1을 설명 없이 갑자기 일반 문자로 바꾸면 안 됩니다.
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);
}
함수들은 앱이 제공한 문자열을 기대합니다. 하나는 첫 일치를, 다른 하나는 모든 일치를 바꿉니다. replaceLiteralAll만 빈 검색값을 거부해 코드 단위 사이마다 예상치 못한 삽입이 생기는 것을 막습니다. replaceLiteralOnce에 빈 검색값을 주면 문자열 맨 앞에 치환값이 삽입됩니다. 제품이 의도적으로 캡처 템플릿을 지원한다면 그 모드를 보존하고 의미를 몰래 바꾸지 말고 명확히 표시하세요.
최종 사용 맥락에서 전체 변경을 미리 보여주세요
특히 모두 바꾸기에서는 원본과 결과를 함께 보여주세요. 달러 하나, 달러 둘, 일치 토큰, 빈 문자열을 치환값으로 시험합니다. 일치가 없을 때도 확인하세요. 빈 치환은 정상적인 삭제이지만 빈 검색은 문자열 곳곳 사이에 삽입할 수 있으므로 제품에서 명확히 결정해야 합니다.
마지막으로 결과 표시 방식도 보세요. 콜백에서 일반 문자를 반환한다고 HTML까지 안전해지는 것은 아닙니다. 신뢰할 수 없는 텍스트 미리보기에는 textarea나 textContent를 써서 붙인 태그가 실행되지 않고 보이게 하세요. 미리보기가 의도와 맞을 때만 저장·제출하고 일괄 편집에는 되돌리기 경로를 남깁니다.
기록된 시험에서는 콜백이 반환한 $&, $', $$, $1이 정확히 유지됐습니다. 반복 일치와 빈 치환을 포함해 비슷한 예시를 자신의 비회귀 시험에도 넣으세요. 원본을 보관하고 일괄 편집을 미리 확인하세요.
