📚 Reference

• 공식 문서 1

📜 Chapter

toLocaleUpperCase

• toLocaleUpperCase
• JavaScript에서 문자열을 대문자로 변환할 때 사용하는 메서드이다.
• 기존의 toUpperCase() 메서드와 기능적으로 매우 유사하지만, 가장 큰 차이점은 "특정 지역 언어(Locale)의 규칙을 반영하여 대문자로 변환한다"는 점이다.

str.toLocaleUpperCase()
str.toLocaleUpperCase(locales)

• locales (선택 사항): 어떤 지역의 대/소문자 매핑 규칙을 사용할지 지정하는 BCP 47 언어 태그(예: 'en-US', 'tr', 'ko-KR') 또는 그 배열이다. 이 값을 생략하면 호스트 환경(브라우저나 실행 시스템)의 현재 지역 설정(Locale)을 기본값으로 사용한다.
• 반환 값: 기존 문자열은 변경되지 않으며, 해당 지역 규칙에 맞춰 대문자로 변환된 새로운 문자열을 반환한다.

왜 toUpperCase() 대신 toLocaleUpperCase()를 쓸까?

• 대부분의 영어 알파벳 문자는 toUpperCase()와 toLocaleUpperCase()의 결과가 동일하다. 하지만 일부 국가의 언어는 유니코드의 일반적인 대/소문자 변환 규칙과 다른 고유한 규칙을 가진다.
• 가장 대표적인 예가 터키어(Turkish)이다.
  • 영어에서는 소문자 i를 대문자로 바꾸면 점이 없는 I가 된다.
  • 반면 터키어에서는 점이 있는 소문자 i를 대문자로 바꾸면 점이 있는 대문자 İ가 되어야 하고, 점이 없는 소문자 ı를 대문자로 바꾸어야 점이 없는 대문자 I가 된다.

const city = "istanbul";

// 1. 일반적인 대문자 변환 (영어 규칙)
console.log(city.toUpperCase());                // "ISTANBUL"
console.log(city.toLocaleUpperCase('en-US'));    // "ISTANBUL"

// 2. 터키어 규칙 적용 변환
console.log(city.toLocaleUpperCase('tr'));       // "İSTANBUL" (앞글자 I 위에 점이 붙음!)

• 만약 터키 사용자를 대상으로 하는 웹서비스에서 사용자가 입력한 아이디나 도시 이름을 단순히 toUpperCase()로 처리한다면, 터키어 규칙이 깨져서 올바르지 않은 글자로 변환되거나 검색/비교 기능이 오작동할 수 있다. toLocaleUpperCase()는 이러한 다국어 환경에서의 문제를 방지해 준다.

특징