비동기와 네트워크

NeonJS는 Promise와 async/await를 표준 그대로 지원해요. StarLight는 프로젝트마다 이벤트 루프를 돌려서, 타이머와 fetch, WebSocket의 결과를 프로젝트의 작업으로 처리해요.

async 이벤트 함수#

이벤트 함수도 async로 만들 수 있어요. 함수 안에서 await를 쓰면 응답을 기다리는 동안 다른 이벤트가 먼저 처리될 수 있어요.

export async function onMessage(event) {
    if (event.message !== "/고양이") return;

    const res = await fetch("https://api.example.com/cat-fact");
    const { fact } = await res.json();
    event.room.send(fact);
}

모듈 최상위의 await#

NeonJS 프로젝트는 ES 모듈이라 최상위에서도 await를 쓸 수 있어요. 컴파일은 최상위 코드가 끝날 때까지 기다리므로, 시작할 때 한 번 받아 올 데이터를 준비하기에 좋아요.

const res = await fetch("https://example.com/words.json");
const words = await res.json();

export function onMessage(event) {
    if (words.includes(event.message)) event.room.send("찾았어요!");
}

최상위 코드가 오래 걸리면 그만큼 컴파일도 늦어져요. 실패해도 괜찮은 작업은 try/catch로 감싸 두세요.

타이머#

setTimeout, setInterval, clearTimeout, clearInterval은 StarLight가 직접 제공해요.

const id = setInterval(() => console.log("1분마다"), 60_000);
// 나중에
clearInterval(id);

• setInterval은 콜백이 끝난 뒤부터 다시 시간을 재요. 콜백이 오래 걸리면 그만큼 간격이 벌어져요.
• 프로젝트를 다시 컴파일하거나 스코프를 폐기하면 남은 타이머는 모두 취소돼요. 프로젝트 스위치를 꺼도 타이머는 계속 돌아요.
• 콜백에서 난 오류는 Exception on timer <ID>: …로 로그에 남고, setInterval은 다음 차례에 계속 실행돼요.

fetch#

fetch는 웹 표준과 같아요. 요청 본문으로 문자열, FormData, Blob, URLSearchParams를 보낼 수 있고, 응답은 text(), json(), arrayBuffer(), bytes(), blob(), formData()로 읽어요.

const res = await fetch("https://api.example.com/items", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ name: "별" }),
    signal: AbortSignal.timeout(5_000),   // 5초가 지나면 취소
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const item = await res.json();

StarLight에서 fetch가 닿을 수 있는 곳은 아래와 같아요.

• 리디렉션은 20번까지 따라가고, 쿠키를 보내거나 저장하지 않으며, 캐시도 쓰지 않아요.
• 동시에 진행할 수 있는 요청은 프로젝트마다 16개, 응답 하나의 크기는 32MiB까지예요.
• 연결에 실패하면 TypeError: fetch failed로 거부되고, 원인은 오류의 cause에 들어 있어요.

WebSocket#

WebSocket도 웹 표준과 같고, fetch와 같은 주소 규칙을 따라요. 소켓은 close()로 닫거나 프로젝트를 다시 컴파일할 때까지 열려 있어요.

const ws = new WebSocket("wss://echo.example.com");
ws.addEventListener("open", () => ws.send("안녕"));
ws.addEventListener("message", (e) => console.log("받음:", e.data));
ws.addEventListener("error", (e) => console.error(e.message));

놓친 오류#

어디서도 잡지 않은 오류는 프로젝트 로그에 오류로 남아요.

메시지 뒤에는 JS 스택 트레이스가 붙어 있어서, 어느 파일 몇 번째 줄에서 났는지 볼 수 있어요.

오래 걸리는 코드#

NeonJS 프로젝트는 한 번에 한 작업만 실행해요. 이벤트 함수 하나가 오래 걸리면 그동안 다른 메시지는 기다려요. 그리고 StarLight는 실행 시간을 제한하지 않아서, 끝나지 않는 반복문은 프로젝트를 멈추게 해요.

• 무거운 계산은 나누어 setTimeout으로 이어서 실행하세요.
• 기다리는 작업은 반복문으로 확인하지 말고 await나 타이머를 쓰세요.
• 프로젝트가 멈췄다면 다시 컴파일하거나 프로젝트 설정의 위험 → 프로젝트 스코프 폐기를 쓰세요. 실행 중인 코드는 그때 중단돼요.