layout

title

subhead

authors

description

date

updated

hero

hero_position

alt

배경

WebTransport란 무엇입니까?

WebTransport는 HTTP/3 프로토콜을 양방향 전송으로 사용하는 웹 API입니다. 웹 클라이언트와 HTTP/3 서버 간의 양방향 통신을 위한 것입니다. 데이터그램 API를 통해 데이터를 안정적으로 전송하지 않고 스트림 API를 통해 안정적으로 데이터 전송을 지원합니다.

데이터그램은 강력한 전달 보장이 필요하지 않은 데이터를 보내고 받는 데 이상적입니다. 데이터의 개별 패킷은 기본 연결의 최대 전송 단위(MTU)에 의해 크기가 제한되며 성공적으로 전송되거나 전송되지 않을 수 있으며 전송되는 경우 임의의 순서로 도착할 수 있습니다. 이러한 특성으로 인해 데이터그램 API는 대기 시간이 짧고 최선의 데이터 전송에 이상적입니다. 데이터그램은 사용자 데이터그램 프로토콜(UDP) 메시지로 생각할 수 있지만 암호화되고 정체가 제어됩니다.

이와 대조적으로 스트림 API는 안정적이고 정렬된 데이터 전송을 제공합니다. 하나 이상의 정렬된 데이터 스트림을 보내거나 받아야 하는 시나리오에 적합합니다. 여러 WebTransport 스트림을 사용하는 것은 여러 TCP 연결을 설정하는 것과 유사하지만 HTTP/3은 내부적으로 더 가벼운 QUIC 프로토콜을 사용하기 때문에 많은 오버헤드 없이 열고 닫을 수 있습니다.

사용 사례

이것은 개발자가 WebTransport를 사용할 수 있는 가능한 방법의 작은 목록입니다.

작고 신뢰할 수 없는 순서가 잘못된 메시지를 통해 서버에 최소한의 대기 시간으로 규칙적인 간격으로 게임 상태를 보냅니다.
다른 데이터 스트림과 관계없이 최소한의 대기 시간으로 서버에서 푸시된 미디어 스트림을 수신합니다.
웹 페이지가 열려 있는 동안 서버에서 푸시된 알림을 수신합니다.

원본 평가판 프로세스의 일부로 WebTransport를 사용하려는 계획에 대해 자세히 듣고 싶습니다.

{% Aside %} 이 제안의 많은 개념은 이전에 Chrome의 일부로 출시되지 않은 이전 QuicTransport 원본 평가판의 일부로 실험되었습니다.

WebTransport는 QUIC 대신 HTTP/3이 기본 전송 프로토콜이라는 주요 차이점을 제외하고 QuickTransport와 유사한 사용 사례를 지원합니다. {% endAside %}

WebTransport와 다른 기술의 관계

WebTransport가 WebSocket을 대체합니까?

어쩌면 그럴 수도 있습니다. WebSocket 또는 WebTransport가 유효한 통신 프로토콜일 수 있는 사용 사례가 있습니다.

WebSockets 통신은 일부 유형의 통신 요구 사항에 적합한 하나의 안정적이고 정렬된 메시지 스트림을 중심으로 모델링됩니다. 이러한 특성이 필요한 경우 WebTransport의 스트림 API도 이러한 특성을 제공할 수 있습니다. 이에 비해 WebTransport의 데이터그램 API는 안정성이나 주문에 대한 보장 없이 짧은 지연 시간 전달을 제공하므로 WebSocket을 직접 대체할 수 없습니다.

데이터그램 API 또는 여러 동시 Streams API 인스턴스를 통해 WebTransport를 사용하면 WebSocket에서 문제가 될 수 있는 헤드 오브 라인 차단에 대해 걱정할 필요가 없습니다. 또한 기본 QUIC 핸드셰이크가 TLS를 통해 TCP를 시작하는 것보다 빠르기 때문에 새 연결을 설정할 때 성능 이점이 있습니다.

WebTransport는 새로운 초안 사양의 일부이며 클라이언트 및 서버 라이브러리를 둘러싼 WebSocket 에코시스템은 현재 훨씬 더 강력합니다. 일반적인 서버 설정과 광범위한 웹 클라이언트 지원으로 "즉시 사용 가능한" 기능이 필요한 경우 오늘날 WebSocket이 더 나은 선택입니다.

WebTransport는 UDP 소켓 API와 동일합니까?

아닙니다. WebTransport는 UDP 소켓 API가 아닙니다. WebTransport는 HTTP/3을 사용하고 UDP는 "후드에서" UDP를 사용하지만 WebTransport는 암호화 및 혼잡 제어에 대한 요구 사항이 있어 기본 UDP 소켓 API 이상입니다.

WebTransport는 WebRTC 데이터 채널의 대안입니까?

네, 클라이언트-서버 연결의 경우 그렇습니다. WebTransport는 기본 프로토콜이 다르지만 WebRTC 데이터 채널과 많은 동일한 속성을 공유합니다.

{% Aside %} WebRTC 데이터 채널은 P2P 통신을 지원하지만 WebTransport는 클라이언트-서버 연결만 지원합니다. 서로 직접 대화해야 하는 여러 클라이언트가 있는 경우 WebTransport는 실행 가능한 대안이 아닙니다. {% endAside %}

일반적으로, HTTP / 3 호환 서버를 실행하는 것은 이해 여러 프로토콜 (포함하는 WebRTC가 서버 유지보다 설치 및 구성이 필요 ICE, DTLS 및 SCTP를 작업 전송을 얻기 위해 참조). WebRTC는 클라이언트/서버 협상 실패로 이어질 수 있는 더 많은 움직이는 부분을 수반합니다.

WebTransport API는 웹 개발자 사용 사례를 염두에 두고 설계되었으며 WebRTC의 데이터 채널 인터페이스를 사용하는 것보다 최신 웹 플랫폼 코드를 작성하는 것과 같은 느낌이 들 것입니다. WebRTC와 달리 WebTransport는 Web Worker 내에서 지원되므로 주어진 HTML 페이지와 독립적으로 클라이언트-서버 통신을 수행할 수 있습니다. WebTransport는 Streams 호환 인터페이스를 노출하기 때문에 backpressure에 대한 최적화를 지원합니다.

그러나 이미 만족스럽게 작동하는 WebRTC 클라이언트/서버 설정이 있는 경우 WebTransport로 전환하는 것이 많은 이점을 제공하지 않을 수 있습니다.

사용해보기

WebTransport를 실험하는 가장 좋은 방법은 호환되는 HTTP/3 서버를 로컬로 시작하는 것입니다. (안타깝게도 최신 사양과 호환되는 공개 참조 서버는 현재 사용할 수 없습니다.) 그러면 이 페이지를 기본 JavaScript 클라이언트와 함께 사용하여 클라이언트/서버 통신을 시도할 수 있습니다.

API 사용

WebTransport는 Streams API와 같은 최신 웹 플랫폼 기본 요소를 기반으로 설계되었습니다. 또한 promise에 크게 의존하며 async 및 await와 원활히 작동합니다.

WebTransport 원본 평가판은 데이터그램과 단방향 및 양방향 스트림의 세 가지 고유한 트래픽 유형을 지원합니다.

서버에 연결

WebTransport 인스턴스를 생성하여 HTTP/3 서버에 연결할 수 있습니다. URL 스키마는 https여야 합니다. 포트 번호를 명시적으로 지정해야 합니다.

연결이 설정될 때까지 기다리 ready promise를 사용해야 합니다. 이 약속은 설정이 완료될 때까지 이행되지 않으며 QUIC/TLS 단계에서 연결이 실패하면 거부됩니다.

closed promise는 연결이 정상적으로 닫힐 때 수행되고 예기치 않은 닫힘이 있는 경우 거부합니다.

서버가 클라이언트 표시 오류(예: URL의 경로가 유효하지 않음)로 인해 연결을 거부하는 경우 ready가 확인되지 않은 상태로 유지되고 closed가 거부됩니다.

const url = 'https://example.com:4999/foo/bar';
const transport = new WebTransport(url);

// Optionally, set up functions to respond to
// the connection closing:
transport.closed.then(() => {
  console.log(`The HTTP/3 connection to ${url} closed gracefully.`);
}).catch((error) => {
  console.error('The HTTP/3 connection to ${url} closed due to ${error}.');
});

// Once .ready fulfills, the connection can be used.
await transport.ready;

데이터그램 API {: #datagram }

서버에 연결된 WebTransport 인스턴스가 있으면 이를 사용하여 데이터그램이라고 하는 개별 데이터 비트를 보내고 받을 수 있습니다.

writeable getter는 웹 클라이언트가 서버에 데이터를 보내는 데 사용할 수 WritableStream를 반환합니다. readable getter는 ReadableStream 반환하여 서버에서 데이터를 수신할 수 있습니다. 두 스트림 모두 본질적으로 신뢰할 수 없으므로 작성하는 데이터가 서버에서 수신되지 않을 수 있으며 그 반대의 경우도 마찬가지입니다.

두 가지 유형의 스트림 모두 Uint8Array 인스턴스를 사용합니다.

// Send two datagrams to the server.
const writer = transport.datagrams.writable.getWriter();
const data1 = new Uint8Array([65, 66, 67]);
const data2 = new Uint8Array([68, 69, 70]);
writer.write(data1);
writer.write(data2);

// Read datagrams from the server.
const reader = transport.datagrams.readable.getReader();
while (true) {
  const {value, done} = await reader.read();
  if (done) {
    break;
  }
  // value is a Uint8Array.
  console.log(value);
}

{% Aside %} Chrome은 현재 ReadableStream에 대한 비동기 반복자를 노출하지 않습니다. 당분간은 getReader() while() 루프와 함께 사용하는 것이 스트림에서 읽는 가장 좋은 방법입니다. {% endAside %}

스트림 API {: #stream }

서버에 연결하면 WebTransport를 사용하여 Streams API를 통해 데이터를 보내고 받을 수도 있습니다.

모든 스트림의 각 청크는 Uint8Array입니다. Datagram API와 달리 이러한 스트림은 신뢰할 수 있습니다. 그러나 각 스트림은 독립적이므로 스트림 전체의 데이터 순서가 보장되지 않습니다.

센드스트림

SendStream WebTransport createSendStream() 메서드를 사용하여 웹 클라이언트에 의해 생성되며, 이 SendStream를 반환합니다.

WritableStreamDefaultWriter 관련 HTTP/3 연결을 닫습니다. 브라우저는 연결된 연결을 실제로 닫기 전에 보류 중인 모든 데이터를 보내려고 합니다.

// Send two Uint8Arrays to the server.
const stream = await transport.createSendStream();
const writer = stream.writable.getWriter();
const data1 = new Uint8Array([65, 66, 67]);
const data2 = new Uint8Array([68, 69, 70]);
writer.write(data1);
writer.write(data2);
try {
  await writer.close();
  console.log('All data has been sent.');
} catch (error) {
  console.error(`An error occurred: ${error}`);
}

마찬가지로 [WritableStreamDefaultWriter](https:/ /developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)에서 QUIC RESET_STREAM을 서버로 보냅니다. abort()를 사용할 때 브라우저는 아직 전송되지 않은 보류 중인 데이터를 삭제할 수 있습니다.

const ws = await transport.createSendStream();
const writer = ws.getWriter();
writer.write(...);
writer.write(...);
await writer.abort();
// Not all the data may have been written.

ReceiveStream

ReceiveStream은 서버에서 시작됩니다. ReceiveStream 얻는 것은 웹 클라이언트에 대한 2단계 프로세스입니다. WebTransport receiveStreams() 메서드를 호출하여 ReadableStream을 반환합니다. ReadableStream의 각 청크는 차례로 서버에서 보낸 Uint8Array 인스턴스를 읽는 데 사용할 수 ReceiveStream에 해당합니다.

async function readFrom(receiveStream) {
  const reader = receiveStream.readable.getReader();
  while (true) {
    const {done, value} = await reader.read();
    if (done) {
      break;
    }
    // value is a Uint8Array
    console.log(value);
  }
}

const rs = transport.receiveStreams();
const reader = rs.getReader();
while (true) {
  const {done, value} = await reader.read();
  if (done) {
    break;
  }
  // value is an instance of ReceiveStream
  await readFrom(value);
}

ReadableStreamDefaultReader의 [ReadableStreamDefaultReader](https: //developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader) promise를 사용하여 스트림 닫힘을 감지할 수 있습니다. 기본 HTTP/3 연결이 FIN 비트로 닫히면 모든 데이터를 읽은 후 닫힌 약속이 이행됩니다. HTTP/3 연결이 갑자기 종료된 경우(예: STREAM_RESET) closed promise가 거부됩니다.

// Assume an active receiveStream
const reader = receiveStream.readable.getReader();
reader.closed.then(() => {
  console.log('The receiveStream closed gracefully.');
}).catch(() => {
  console.error('The receiveStream closed abruptly.');
});

BidirectionalStream

BidirectionalStream은 서버 또는 클라이언트에 의해 생성될 수 있습니다.

createBidirectionalStream() 메서드를 사용하여 생성할 수 있으며, BidirectionalStream WebTransport에 대한 promise를 반환합니다.

const stream = await transport.createBidirectionalStream();
// stream is a BidirectionalStream
// stream.readable is a ReadableStream
// stream.writable is a WritableStream

ReadableStream을 반환하는 WebTransport receiveBidirectionalStreams() 메서드를 사용하여 서버에서 생성한 BidirectionalStream을 수신할 수 있습니다. 따라서 ReadableStream의 각 청크는 BidirectionalStream입니다.

const rs = transport.receiveBidrectionalStreams();
const reader = rs.getReader();
while (true) {
  const {done, value} = await reader.read();
  if (done) {
    break;
  }
  // value is a BidirectionalStream
  // value.readable is a ReadableStream
  // value.writable is a WritableStream
}

BidirectionalStream SendStream과 ReceiveStream의 조합일 뿐입니다. 이전 두 섹션의 예제에서는 각각의 사용 방법을 설명합니다.

더 많은 예

WebTransport 초안 사양에는 모든 메서드 및 속성에 대한 전체 문서와 함께 여러 추가 인라인 예제가 포함되어 있습니다.

Chrome DevTools의 WebTransport

불행히도 WebTransport에 대한 Chrome의 DevTools 지원은 원본 평가판을 시작할 준비가 되지 않았습니다. 이 Chrome 문제에 "별표"를 표시하여 DevTools 인터페이스의 업데이트에 대한 알림을 받을 수 있습니다.

개인 정보 및 보안 고려 사항

신뢰할 수 있는 지침은 사양 초안의 해당 섹션을 참조하십시오.

피드백 {: #feedback }

Chrome 팀은 원본 평가판 프로세스 전반에 걸쳐 이 API를 사용한 사용자 여러분의 생각과 경험을 듣고 싶습니다.

API 설계에 대한 피드백

API에 대해 어색하거나 예상대로 작동하지 않는 것이 있습니까? 아니면 아이디어를 구현하는 데 필요한 누락된 부분이 있습니까?

Web Transport GitHub 리포지토리에 문제를 제출하거나 기존 문제에 생각을 추가하세요.

구현에 문제가 있습니까?

Chrome 구현에서 버그를 찾으셨나요?

https://new.crbug.com에서 버그를 신고하십시오. 복제에 대한 간단한 지침과 함께 가능한 한 많은 세부 정보를 포함하십시오.

API를 사용할 계획이신가요?

공개 지원은 Chrome이 기능의 우선 순위를 지정하는 데 도움이 되며 다른 브라우저 공급업체에서 해당 기능을 지원하는 것이 얼마나 중요한지 보여줍니다.

관심을 표시하고 도메인 및 연락처 정보를 제공하려면 원본 평가판에 가입했는지 확인하십시오.
에 트윗 보내기 @ChromiumDev 해시 태그 사용 #WebTransport 당신이 그것을 사용하는 위치 및 방법에 관한 세부 사항을.

일반 토론

다른 범주에 속하지 않는 일반적인 질문이나 문제에 대해 web-transport-dev Google 그룹을 사용할 수 있습니다.

감사의 말

이 기사는 WebTransport Explainer, 사양 초안 및 관련 설계 문서의 정보를 통합합니다. 그 토대를 마련해 주신 각 저자에게 감사드립니다.

이 게시물의 영웅 이미지는 Unsplash의 Robin Pierre가 제공한 것입니다.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

index.md

index.md

배경

WebTransport란 무엇입니까?

사용 사례

WebTransport와 다른 기술의 관계

WebTransport가 WebSocket을 대체합니까?

WebTransport는 UDP 소켓 API와 동일합니까?

WebTransport는 WebRTC 데이터 채널의 대안입니까?

사용해보기

API 사용

서버에 연결

데이터그램 API {: #datagram }

스트림 API {: #stream }

센드스트림

ReceiveStream

BidirectionalStream

더 많은 예

Chrome DevTools의 WebTransport

개인 정보 및 보안 고려 사항

피드백 {: #feedback }

API 설계에 대한 피드백

구현에 문제가 있습니까?

API를 사용할 계획이신가요?

일반 토론

감사의 말

Files

index.md

Latest commit

History

index.md

File metadata and controls

배경

WebTransport란 무엇입니까?

사용 사례

WebTransport와 다른 기술의 관계

WebTransport가 WebSocket을 대체합니까?

WebTransport는 UDP 소켓 API와 동일합니까?

WebTransport는 WebRTC 데이터 채널의 대안입니까?

사용해보기

API 사용

서버에 연결

데이터그램 API {: #datagram }

스트림 API {: #stream }

센드스트림

ReceiveStream

BidirectionalStream

더 많은 예

Chrome DevTools의 WebTransport

개인 정보 및 보안 고려 사항

피드백 {: #feedback }

API 설계에 대한 피드백

구현에 문제가 있습니까?

API를 사용할 계획이신가요?

일반 토론

감사의 말