Node.js main, WebSocket 프레임 마스킹·해제 API 추가

이번 소식

Node.js 개발 브랜치 main에 WebSocket 프레임 데이터를 마스킹하고 되돌리는 http.websocketMask()·http.websocketUnmask()가 추가됐습니다. 아직 정식 릴리스에 포함됐다고 확인된 기능은 아닙니다.

달라진 점

• websocketMask(source, mask, output, offset, length)는 4바이트 키를 반복 적용해 지정한 길이의 데이터를 출력 버퍼에 씁니다. 출력 위치와 길이는 필수 인자입니다.
• websocketUnmask(buffer, mask)는 받은 버퍼를 직접 수정해 마스킹을 해제합니다.
• Buffer·TypedArray·DataView를 바이트 단위로 처리하며, 원본과 출력이 같은 메모리에서 겹치는 경우도 지원합니다.

어떤 점이 달라지나요?

채팅·실시간 알림 등에 쓰는 WebSocket 라이브러리를 만드는 개발자는 프레임 처리의 일부를 Node.js 내부 구현에 맡기는 경로를 검토할 수 있습니다. 일반 앱이 기존 라이브러리를 쓰는 것만으로 동작이 바뀌는 업데이트는 아닙니다.

현재 운영 환경에서는 지원 여부를 먼저 확인하고 기존 처리 경로를 유지해야 합니다. 새 API의 릴리스 버전은 아직 지정되지 않았으며, 이 글에서는 실행이나 성능 비교를 직접 시험하지 않았습니다.

반영 시각: 2026년 10월 6일 20:36:02 KST · 공식 main 커밋 기준