라이믹스/매뉴얼/프론트엔드 라이브러리/String 확장

상위 문서: 라이믹스/매뉴얼/프론트엔드 라이브러리

1. 개요#

라이믹스가 JavaScript의 String 타입에 제공하는 편의 메서드이다. 라이믹스의 기본 스크립트가 로딩된 페이지를 전제로 하며, 일반 JavaScript 환경에 모두 기본 제공되는 기능은 아니다.

2. 메서드#

메서드	기능과 주의사항
getQuery(key)	URL 문자열의 쿼리스트링에서 지정한 파라미터 값 조회
setQuery(key, val)	URL 문자열에 파라미터 추가 또는 기존 값 대체
escape(double_escape)	HTML 특수문자를 엔티티로 인코딩. false이면 이미 인코딩된 부분을 다시 인코딩하지 않음
unescape()	위 HTML 엔티티 인코딩을 해제
stripTags()	HTML 태그로 보이는 부분 제거
trim()	문자열 앞뒤 공백 제거. 기본 메서드가 없는 환경을 위한 polyfill

3. URL 파라미터#

const url = 'https://example.com/board?page=1';
const page = url.getQuery('page');
const nextUrl = url.setQuery('page', 2);

setQuery()의 결과는 새 URL 문자열로 받아 사용한다. URL을 문자열 연결로 직접 조합하는 것보다 인코딩과 기존 파라미터 처리를 명확하게 할 수 있다. 서버의 짧은주소 생성 규칙이 필요한 경우에는 서버 API와 역할을 구분한다.

4. HTML 처리#

const value = '<b>안내</b>';
const encoded = value.escape();
const restored = encoded.unescape();
const text = value.stripTags();

escape()는 HTML 출력 문맥을 위한 기능이며 SQL·CSS·JavaScript의 모든 위치에 적용되는 범용 검증 함수가 아니다. unescape()로 복원한 문자열이나 stripTags() 결과를 그대로 HTML에 넣어도 안전하다고 가정하지 않는다. 일반 텍스트 표시에는 DOM의 textContent 등을 사용한다.

5. trim과 기본 메서드#

현대 브라우저에 기본 String.prototype.trim()이 있으면 라이믹스는 이를 덮어쓰지 않는다. 기존 스크립트를 라이믹스 밖으로 옮길 때는 라이믹스 전용 확장과 브라우저 기본 메서드를 구분한다.

6. 같이 보기#

• 라이믹스/매뉴얼/프론트엔드 라이브러리
• 라이믹스/매뉴얼/프론트엔드 라이브러리/전역 함수

7. 출처#

이 문서는 라이믹스 공식 매뉴얼을 바탕으로 설명과 예제를 정리하였다. 공식 매뉴얼은 CC BY-SA 4.0으로 배포된다. 원문의 기여 이력은 rhymix-docs 저장소에서 확인할 수 있다.