compression-ja.html

<!DOCTYPE html><html lang="ja"><head><meta charset="utf-8">
<title>Compression （日本語訳）</title>

<link rel="stylesheet" href="common.css" type="text/css">
<link rel="stylesheet" href="common-whatwg.css" type="text/css">

<script src="common0.js"></script>
<script src="common1.js" async></script>

<script>

Util.ready = function(){
	const source_data = {
		toc_main: 'MAIN0',
		persisted_parts: { _acks1: E('_acks1'), _ipr1: E('_ipr1') },
		generate: expand
	};
	Util.switchWordsInit(source_data);
}


function expand(){
	const class_map = this.class_map;
	const tag_map = this.tag_map;
	const link_map = this.link_map;

	return this.html.replace(
		/%[\w\-~一-鿆あ-ん]+|`(.+?)([$@\^])(\w*)/g,
		create_html
	);

	function create_html(match, key, indicator, klass){

if(!indicator) {//%
	return `<var>${match.slice(1)}</var>`;
}

let href = '';
let href1 = '';
{
	const n = key.indexOf('＠');
	if(n > 0) {
		href1 = key.slice(n + 1);
		key = key.slice(0, n);
	}
}
let text = key;

switch(klass){
case 'r':
	text = `[${key}]`;
	href = `#biblio-${key.toLowerCase()}`;
	break;
case 'm':
	const n = text.indexOf('(');
	if(n > 0){
		key = text.slice(0, n);
		text = key + text.slice(n).replace(/\w+/g, '<var>$&</var>');
	}
	break;
case 'l':
	text = `"<code class="literal">${text}</code>"`;
	break;
case 'en':
	return `<span lang="en">${key}</span>`;
	break;
}

let tag = tag_map[klass];
if(tag) {
	let classname = class_map[klass];
	classname = classname ? ` class="${classname}"` : '';
	text = `<${tag}${classname}>${text}</${tag}>`;
}

if(indicator !== '^'){
	href = href1 || link_map[ klass ? `${klass}.${key}` : key ] || href;
	if(!href){
		console.log(match); // check error
		return match;
	}

	switch(indicator){
	case '$':
		text = `<a href="${href}">${text}</a>`;
		break;
	case '@':
		text = `<dfn id="${href.slice(1)}">${text}</dfn>`;
		break;
	}
}

return text;


	}
}

</script>

<script type="text/plain" id="_source_data">


●●options

spec_date:2025-02-27
trans_update:2024-12-03
source_checked:241021
spec_status:LS
original_url:https://compression.spec.whatwg.org/
	abbr_url:COMPRESSION
ref_id_prefix:biblio-
ref_id_lowercase:true
	site_nav:
copyright:,whatwg
trans_1st_pub:2024-12-03


●●class_map
E:error

●●tag_map
I:code
m:code
E:code
c:code
i:i

●●original_id_map

●●mdn_urls
compressionstream:API/CompressionStream
decompressionstream:API/DecompressionStream

●●link_map

	●IDL

E.TypeError:~WEBIDL#exceptiondef-typeerror
I.BufferSource:~WEBIDL#BufferSource
I.Uint8Array:~WEBIDL#idl-Uint8Array
I.Blob:~FILEAPI#blob
I.ArrayBuffer:~WEBIDL#idl-ArrayBuffer

I.GenericTransformStream:~STREAMS#generictransformstream
I.ReadableStream:~STREAMS#readablestream
I.TransformStream:~STREAMS#transformstream
I.WritableStream:~STREAMS#writablestream

I.CompressionFormat:#enumdef-compressionformat
I.CompressionStream:#compressionstream
I.DecompressionStream:#decompressionstream

m.new CompressionStream:#dom-compressionstream-compressionstream
	%format:#dom-compressionstream-compressionstream-format-format
m.new DecompressionStream:#dom-decompressionstream-decompressionstream
	%format:#dom-decompressionstream-decompressionstream-format-format


l.deflate:#dom-compressionformat-deflate
l.deflate-raw:#dom-compressionformat-deflate-raw
l.gzip:#dom-compressionformat-gzip

	●用語
文脈:#compression-context
圧縮~文脈:#compressionstream-context
圧縮~形式:#compressionstream-format
~chunkを圧縮して~enqueueする:#compress-and-enqueue-a-chunk
圧縮-用の書出nを~enqueueする:#compress-flush-and-enqueue
文脈:#decompressionstream-context
解凍~文脈:#decompressionstream-context
~chunkを解凍して~enqueueする:#decompress-and-enqueue-a-chunk
解凍-用の書出nを~enqueueする:#decompress-flush-and-enqueue
解凍~形式:#decompressionstream-format

	●用語（外部
~byte列:~INFRA#byte-sequence
実装定義:~INFRA#implementation-defined

TS.設定しておく:~STREAMS#transformstream-set-up
TS.~chunkを~enqueueする:~STREAMS#transformstream-enqueue
GTS.形式変換:~STREAMS#generictransformstream-transform
	i.書出n~algo:~STREAMS#transformstream-set-up-flushalgorithm
	i.形式変換~algo:~STREAMS#transformstream-set-up-transformalgorithm

新たな~obj:~WEBIDLjs#new
~buffer~sourceを~byte列から作成する:~WEBIDLjs#_buffersource-create

内容~符号法:~HTTPsem#content.codings

_acks1:#_acks1
_ipr1:#_ipr1

●●words_table1

●●words_table

	●圧縮／stream
chunk::::チャンク
形式変換:transform::~
圧縮-:compress::~
圧縮:compression::~
解凍-:decompress::~
解凍:decompression::~
書出n:flush::書き出し
書出して:flushして::書き出して
checksum:
piece:

	●変数
	-:transformAlgorithm
	-:flushAlgorithm
	-:arrays
	%配列:array
	%~buffer:buffer
	%cs
	%ds
	%~piece:~
	^en:the finish flag

	●保安
特権:privilege::~

	●仕様
準拠する:compliantになる:~
見越す:anticipateする:~
推測-:guess:~

	一群の:set of
	広く:widely
	と称される:referred to as
	注意を払う:pay attention
	を~supportしない:unsupported
	視点:point of view

	●未分類
符号法:coding::~::コーディング
	内容~符号法:Content-Encodings

最終-:final:~
	`gzip^l で:gzip-
	`deflate^l で:deflate-
	`CompressionStream$I :CompressionStream
	`DecompressionStream$I :DecompressionStream
	`Uint8Array$I :Uint8Array
	`ArrayBuffer$I :ArrayBuffer
	`Blob$I :Blob


●●ref_normative

[INFRA]
    Anne van Kesteren; Domenic Denicola. ＜Infra Standard＞. Living Standard. URL: https://infra.spec.whatwg.org/
[RFC1950]
    P. Deutsch; J-L. Gailly. ＜ZLIB Compressed Data Format Specification version 3.3＞. May 1996. Informational. URL: https://www.rfc-editor.org/rfc/rfc1950
[RFC1951]
    P. Deutsch. ＜DEFLATE Compressed Data Format Specification version 1.3＞. May 1996. Informational. URL: https://www.rfc-editor.org/rfc/rfc1951
[RFC1952]
    P. Deutsch. ＜GZIP file format specification version 4.3＞. May 1996. Informational. URL: https://www.rfc-editor.org/rfc/rfc1952
[STREAMS]
    Adam Rice; et al. ＜Streams Standard＞. Living Standard. URL: https://streams.spec.whatwg.org/
[WEBIDL]
    Edgar Chen; Timothy Gu. ＜Web IDL Standard＞. Living Standard. URL: https://webidl.spec.whatwg.org/

●●ref_informative

[RFC7230]
    R. Fielding, Ed.; J. Reschke, Ed.. ＜Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing＞. June 2014. Proposed Standard. URL: https://httpwg.org/specs/rfc7230.html

●●trans_metadata
<p>
~THIS_PAGEは、
<a href="https://www.whatwg.org/">WHATWG</a>
による
<a href="~SPEC_URL">Compression</a>
を日本語に翻訳したものです。
~PUB
</p>


●●spec_metadata

Participate:
	<a href="https://github.com/whatwg/compression">GitHub whatwg/compression</a> (<a href="https://github.com/whatwg/compression/issues/new/choose">new issue</a>, <a href="https://github.com/whatwg/compression/issues">open issues</a>)
	<a href="https://whatwg.org/chat">Chat on Matrix</a>

Commits:
	https://github.com/whatwg/compression/commits
	<a href="/commit-snapshots/ab632acc733ede6841ad9cbdce8d173f5f0792d7/" id="commit-snapshot-link">Snapshot as of this commit</a>
	<a href="https://twitter.com/compressionapi">@compressionapi</a>
Tests:
	<a href="https://github.com/web-platform-tests/wpt/tree/master/compression">web-platform-tests compression/</a> (<a href="https://github.com/web-platform-tests/wpt/labels/compression">ongoing work</a>)

</script>

</head>

<body>

<header>

<a href="https://whatwg.org/"><img style="float: right;" alt="WHATWG" src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMDAgMTAwIiBzdHJva2U9IiMzYzc5MGEiIHN0cm9rZS13aWR0aD0iMTAiPgo8ZGVmcz4KPG1hcmtlciBpZD0iYSIgb3ZlcmZsb3c9InZpc2libGUiIG1hcmtlckhlaWdodD0iMSIgbWFya2VyV2lkdGg9IjEiIG9yaWVudD0iYXV0byIgdmlld0JveD0iMCAwIDIgMiI+CjxwYXRoIGQ9Im0wIDAtMyAzIEwwIDAtMy0zIiBzdHJva2Utd2lkdGg9IjIiLz4KPC9tYXJrZXI+CjwvZGVmcz4KPGNpcmNsZSBjeD0iNTAiIGN5PSI1MCIgcj0iNDUiIGZpbGw9IiNmZmYiLz4KPHBhdGggZD0ibTcwIDcwLTQwLTQwIi8+CjxwYXRoIGQ9Im04MCAyMC0yMCAyMCIgbWFya2VyLWVuZD0idXJsKCNhKSIvPgo8cGF0aCBkPSJtMjAgODArMjAtMjAiIG1hcmtlci1lbmQ9InVybCgjYSkiLz4KPC9zdmc+Cg==" height="100"></a>


	<hgroup>
<h1>Compression</h1>
	</hgroup>
</header>

<div id="MAIN" hidden>
	<section id="abstract">
◎要約

<p>
この文書は、
~binary~dataが成す~streamを［
圧縮する／
解凍する
］ための，一群の~JS~APIを定義する。
◎
This document defines a set of JavaScript APIs to compress and decompress streams of binary data.
</p>

	</section>

<main id="MAIN0">

	<section id="introduction">
<h2 title="Introduction">1. 序論</h2>

◎非規範的

<p>
この仕様において指定される~APIは、
~dataが成す~streamを［
圧縮する／解凍する
］ために利用される。
それらは
圧縮~algoとして［
`deflate$l, `deflate-raw$l, `gzip$l
］を~supportする。
それらの~algoは、
~web開発者により広く利用される。
◎
The APIs specified in this specification are used to compress and decompress streams of data. They support "deflate", "deflate-raw" and "gzip" as compression algorithms. They are widely used by web developers.
</p>

	</section>
	<section id="infrastructure">
<h2 title="Infrastructure">2. 基盤</h2>

<p>
この仕様は、
`INFRA$r に依存する
◎
This specification depends on Infra. [INFRA]
</p>

<p>
~chunkは、
~dataを成す ある~pieceである。
［
`CompressionStream$I ／ `DecompressionStream$I
］の事例においては、
出力~chunkの型は `Uint8Array$I であり，
入力として `BufferSource$I 型の値を受容する。
◎
A chunk is a piece of data. In the case of CompressionStream and DecompressionStream, the output chunk type is Uint8Array. They accept any BufferSource type as input.
</p>

<p>
~streamは、
~chunkたちが成す有順序な連列を表現する。
用語［
`ReadableStream$I, `WritableStream$I
］は `STREAMS$r にて定義される。
◎
A stream represents an ordered sequence of chunks. The terms ReadableStream and WritableStream are defined in Streams. [STREAMS]
</p>

<p>
`文脈@
とは、［
圧縮~algo／解凍~algo
］により保守される内部~状態である。
`文脈$を成す内容は、
利用-中にある［
形式, ~algo, 実装
］に依存する。
それは、
この仕様の視点からは，不透明な~objである。
`文脈$は、
初期~時は，開始-状態
— 入力を成す最初の~byteを見越すような状態 —
にある。
◎
A compression context is the internal state maintained by a compression or decompression algorithm. The contents of a compression context depend on the format, algorithm and implementation in use. From the point of view of this specification, it is an opaque object. A compression context is initially in a start state such that it anticipates the first byte of input.
</p>

	</section>
	<section id="supported-formats">
<h2 title="Supported formats">3. ~supportされる形式</h2>

<dl>
	<dt>`deflate$l</dt>
	<dd>
<p>
ZLIB で圧縮された~data形式
（ `ZLIB Compressed Data Format^en ）
`RFC1950$r
◎
"ZLIB Compressed Data Format" [RFC1950]
</p>

<p class="note">注記：
この形式は、
~HTTP`内容~符号法$との一貫性を得るため， "deflate" と称される。
`RFC7230$r § 4.2.2 【 `RFC9110^r `§ 8.4.1.2＠~HTTPsem#deflate.coding$ 】を見よ。
◎
Note: This format is referred to as "deflate" for consistency with HTTP Content-Encodings. See [RFC7230] section 4.2.2.
</p>
		<ul>
			<li>
実装は、
`RFC1950$r § 2.3 にて述べられるとおりに “準拠する” モノトスル。
◎
Implementations must be "compliant" as described in [RFC1950] section 2.3.
</li>
			<li>
`CompressionStream$I は、［
`RFC1950$r において妥当でないものと述べられた~field値
］を作成しないモノトスル。
そのような値は、
`DecompressionStream$I 用には~errorになるとする。
◎
Field values described as invalid in [RFC1950] must not be created by CompressionStream, and are errors for DecompressionStream.
</li>
			<li>
`CMF^i ~fieldを成す［
`CM^i （ `Compression method^en ）が成す部分
］【圧縮~methodを指示する部分】用に妥当な値は 8 に限られる。
◎
The only valid value of the CM (Compression method) part of the CMF field is 8.
</li>
			<li>
この~APIは、
`FDICT^i ~flagを~supportしない
— 【この~flag用の~bitが 1 に】設定された場合、
当の~streamは~errorになるとする。
◎
The FDICT flag is not supported by these APIs, and will error the stream if set.
</li>
			<li>
`DecompressionStream$I は、
`FLEVEL^i ~flagを無視する。
◎
The FLEVEL flag is ignored by DecompressionStream.
</li>
			<li>
`ADLER32^i ~checksumが正しくない場合、
`DecompressionStream$I 用には，~errorになるとする。
◎
It is an error for DecompressionStream if the ADLER32 checksum is not correct.
</li>
			<li>
`ADLER32^i ~checksumより後に追加的な入力~dataが在る場合、
~errorになるとする。
◎
It is an error if there is additional input data after the ADLER32 checksum.
</li>
		</ul>
	</dd>

	<dt>`deflate-raw$l</dt>
	<dd>
<p>
DEFLATE ~algo
（ `The DEFLATE algorithm^en ）
`RFC1951$r
◎
"The DEFLATE algorithm" [RFC1951]
</p>
		<ul>
			<li>
実装は、
`RFC1951$r § 1.4 にて述べられるとおりに “準拠する” モノトスル。
◎
Implementations must be "compliant" as described in [RFC1951] section 1.4.
</li>
			<li>
`CompressionStream$I は、
`RFC1951$r に適合していない~blockを作成しないモノトスル。
そのような~blockは、
`DecompressionStream$I 用には~errorになるとする。
◎
Non-[RFC1951]-conforming blocks must not be created by CompressionStream, and are errors for DecompressionStream.
</li>
			<li>
`BFINAL^i ~flagにより指示される最終-~blockより後に追加的な入力~dataが在る場合、
~errorになるとする。
◎
It is an error if there is additional input data after the final block indicated by the BFINAL flag.
</li>
		</ul>
	</dd>

	<dt>`gzip$l</dt>
	<dd>
<p>
GZIP ~file形式
（ `GZIP file format^en ）
`RFC1952$r
◎
"GZIP file format" [RFC1952]
</p>
		<ul>
			<li>
`RFC1952$r § 2.3.1.2 にて述べられるとおりに “準拠する” モノトスル。
◎
Implementations must be "compliant" as described in [RFC1952] section 2.3.1.2.
</li>
			<li>
`CompressionStream$I は、［
`RFC1952$r において妥当でないものと述べられた~field値
］を作成しないモノトスル。
そのような値は、
`DecompressionStream$I 用には~errorになるとする。
◎
Field values described as invalid in [RFC1952] must not be created by CompressionStream, and are errors for DecompressionStream.
</li>
			<li>
`CM^i ~field用に妥当な値は 8 に限られる。
◎
The only valid value of the CM (Compression Method) field is 8.
</li>
			<li>
`DecompressionStream$I は、
`FTEXT^i ~flagを無視するモノトスル。
◎
The FTEXT flag must be ignored by DecompressionStream.
</li>
			<li>
不正な `FHCRC^i ~fieldが在る場合、
~errorになるとする。
◎
If the FHCRC field is present, it is an error for it to be incorrect.
</li>
			<li>
`DecompressionStream$I は、
次に挙げる~fieldを成す内容を
— それらが正しく終了されたか否か検証yすることを除いて —
無視するモノトスル
⇒＃
`FEXTRA^i,
`FNAME^i,
`FCOMMENT^i
◎
The contents of any FEXTRA, FNAME and FCOMMENT fields must be ignored by DecompressionStream, except to verify that they are terminated correctly.
</li>
			<li>
`DecompressionStream$I は、
次に挙げる~fieldを成す内容を無視するモノトスル
⇒＃
`MTIME^i,
`XFL^i,
`OS^i
◎
The contents of the MTIME, XFL and OS fields must be ignored by DecompressionStream.
</li>
			<li>
次に挙げるいずれかの~fieldを成す内容が解凍された~dataに合致しない場合、
~errorになるとする
⇒＃
`CRC32^i,
`ISIZE^i
◎
It is an error if CRC32 or ISIZE do not match the decompressed data.
</li>
			<li>
`gzip^i ~streamは、
1 個の “~member” （ `member^en ） しか包含し得ない
— 当の~memberの終端より後に追加的な入力~dataが在る場合、
~errorになるとする。
◎
A gzip stream may only contain one "member".
◎
It is an error if there is additional input data after the end of the "member".
</li>
		</ul>
	</dd>
</dl>

	</section>
	<section id="compression-stream">
<h2 title="Interface CompressionStream">4. `CompressionStream^I ~interface</h2>

<pre class="idl">
enum `CompressionFormat@I {
  `deflate@l,
  `deflate-raw@l,
  `gzip@l,
};

[Exposed=*]
interface `CompressionStream@I {
  `constructor＠#dom-compressionstream-compressionstream$(`CompressionFormat$I %format);
};
`CompressionStream$I includes `GenericTransformStream$I;
</pre>

<div>
<p>
各 `CompressionStream$I には、
次に挙げるものが結付けられる：
</p>
<ul>
	<li>
`圧縮~形式@
⇒
ある `CompressionFormat$I 値
</li>
	<li>
`圧縮~文脈@
⇒
ある`文脈$
</li>
</ul>
◎
A CompressionStream has an associated format and compression context context.
</div>

<div class="algo">
<p>
`new CompressionStream(format)@m
構築子~手続きは：
◎
The new CompressionStream(format) steps are:
</p>
<ol>
	<li>
~IF［
`CompressionStream$I は %format を~supportしない
］
⇒
~THROW `TypeError$E
◎
If format is unsupported in CompressionStream, then throw a TypeError.
</li>
	<li>
コレの`圧縮~形式$ ~SET %format
◎
Set this’s format to format.
</li>
	<li>
コレの`形式変換$GTS ~SET `新たな~obj$( `TransformStream$I )
◎
↓</li>
	<li>
<p>
コレの`形式変換$GTSを`設定しておく$TS
— 次を与える下で：
</p>
		<ul>
			<li class="algo">
`形式変換~algo^i ~SET 所与の ( %~chunk ) に対し，次を走らす~algo
⇒
`~chunkを圧縮して~enqueueする$( コレ, %~chunk )
</li>
			<li class="algo">
`書出n~algo^i ~SET 次を走らす~algo
⇒
`圧縮-用の書出nを~enqueueする$( コレ )
</li>
		</ul>
◎
Let transformAlgorithm be an algorithm which takes a chunk argument and runs the compress and enqueue a chunk algorithm with this and chunk.
◎
Let flushAlgorithm be an algorithm which takes no argument and runs the compress flush and enqueue algorithm with this.
◎
Set this’s transform to a new TransformStream.
◎
Set up this’s transform with transformAlgorithm set to transformAlgorithm and flushAlgorithm set to flushAlgorithm.
</li>
</ol>
</div>

<div class="algo">
<p>
`~chunkを圧縮して~enqueueする@
~algoは、
所与の
( `CompressionStream$I ~obj %cs, %~chunk )
に対し：
◎
The compress and enqueue a chunk algorithm, given a CompressionStream object cs and a chunk, runs these steps:
</p>
<ol>
	<li>
~IF［
%~chunk は `BufferSource$I 型でない
］
⇒
~THROW `TypeError$E
◎
If chunk is not a BufferSource type, then throw a TypeError.
</li>
	<li>
%~buffer ~LET %cs の［
`圧縮~形式$, `圧縮~文脈$
］を用いて，
%~chunk を圧縮した結果
◎
Let buffer be the result of compressing chunk with cs’s format and context.
</li>
	<li>
~IF［
%~buffer は空である
］
⇒
~RET
◎
If buffer is empty, return.
</li>
	<li>
<p>
%~buffer を 1 個~以上の空でない~pieceに分割した結果†を成す
~EACH( %~piece )
に対し：
</p>
		<ol>
			<li>
%配列 ~LET %~piece を `Uint8Array$I へ変換した結果††
</li>
			<li>
%cs の`形式変換$GTSに`~chunkを~enqueueする$TS( %配列 )
</li>
		</ol>

<p class="trans-note">【†
どう分割するかは、
指定されていない
（したがって，`実装定義$になろう）
— 他の~algoでも同様。
】【††
この~algoは、
~pieceの~data型について何も述べておらず，
`Uint8Array$I へ変換するための詳細も指定していないが、
~pieceは`~byte列$であると見做すなら，［
`~buffer~sourceを~byte列から作成する$( `Uint8Array$I, %~piece )
］の結果になろう
— 他の~algoでも同様。
】</p>
◎
Let arrays be the result of splitting buffer into one or more non-empty pieces and converting them into Uint8Arrays.
◎
For each Uint8Array array of arrays, enqueue array in cs’s transform.
</li>
</ol>
</div>

<div class="algo">
<p>
`圧縮-用の書出nを~enqueueする@
~algoは、
入力 `ReadableStream$I ~objからの~dataの終端を取扱う。
それは、
所与の
( `CompressionStream$I ~obj %cs )
に対し：
◎
The compress flush and enqueue algorithm, which handles the end of data from the input ReadableStream object, given a CompressionStream object cs, runs these steps:
</p>
<ol>
	<li>
%~buffer ~LET %cs の［
`圧縮~形式$, `圧縮~文脈$
］を用いて, および
`the finish flag^en
【これが具体的に どう働くかは指定されていない】
を伴わせて，
空な入力を圧縮した結果
◎
Let buffer be the result of compressing an empty input with cs’s format and context, with the finish flag.
</li>
	<li>
~IF［
%~buffer は空である
］
⇒
~RET
◎
If buffer is empty, return.
</li>
	<li>
<p>
%~buffer を 1 個~以上の空でない~pieceに分割した結果を成す
~EACH( %~piece )
に対し：
</p>
		<ol>
			<li>
%配列 ~LET %~piece を `Uint8Array$I へ変換した結果
</li>
			<li>
%cs の`形式変換$GTSに`~chunkを~enqueueする$TS( %配列 )
</li>
		</ol>
◎
Let arrays be the result of splitting buffer into one or more non-empty pieces and converting them into Uint8Arrays.
◎
For each Uint8Array array of arrays, enqueue array in cs’s transform.
</li>
</ol>
</div>

	</section>
	<section id="decompression-stream">
<h2 title="Interface DecompressionStream">5. `DecompressionStream^I ~interface</h2>

<pre class="idl">
[Exposed=*]
interface `DecompressionStream@I {
  `constructor＠#dom-decompressionstream-decompressionstream$(`CompressionFormat$I %format);
};
`DecompressionStream$I includes `GenericTransformStream$I;
</pre>

<div>
<p>
各 `DecompressionStream$I には、
次に挙げるものが結付けられる：
</p>
<ul>
	<li>
`解凍~形式@
⇒
ある `CompressionFormat$I 値
</li>
	<li>
`解凍~文脈@
⇒
ある`文脈$
</li>
</ul>
◎
A DecompressionStream has an associated format and compression context context.
</div>

<div class="algo">
<p>
`new DecompressionStream(format)@m
構築子~手続きは：
◎
The new DecompressionStream(format) steps are:
</p>
<ol>
	<li>
~IF［
`DecompressionStream$I は %format を~supportしない
］
⇒
~THROW `TypeError$E
◎
If format is unsupported in DecompressionStream, then throw a TypeError.
</li>
	<li>
コレの`解凍~形式$ ~SET %format
◎
Set this’s format to format.
</li>
	<li>
コレの`形式変換$GTS ~SET `新たな~obj$( `TransformStream$I )
◎
↓</li>
	<li>
<p>
コレの`形式変換$GTSを`設定しておく$TS
— 次を与える下で：
</p>
		<ul>
			<li class="algo">
`形式変換~algo^i ~SET  所与の ( %~chunk ) に対し，次を走らす~algo
⇒
`~chunkを解凍して~enqueueする$( コレ, %~chunk )
</li>
			<li class="algo">
`書出n~algo^i ~SET 次を走らす~algo
⇒
`解凍-用の書出nを~enqueueする$( コレ )
</li>
		</ul>
◎
Let transformAlgorithm be an algorithm which takes a chunk argument and runs the decompress and enqueue a chunk algorithm with this and chunk.
◎
Let flushAlgorithm be an algorithm which takes no argument and runs the decompress flush and enqueue algorithm with this.
◎
Set this’s transform to a new TransformStream.
◎
Set up this’s transform with transformAlgorithm set to transformAlgorithm and flushAlgorithm set to flushAlgorithm.
</li>
</ol>
</div>

<div class="algo">
<p>
`~chunkを解凍して~enqueueする@
~algoは、
所与の
( `DecompressionStream$I ~obj %ds, %~chunk )
に対し：
◎
The decompress and enqueue a chunk algorithm, given a DecompressionStream object ds and a chunk, runs these steps:
</p>
<ol>
	<li>
~IF［
%~chunk は `BufferSource$I 型でない
］
⇒
~THROW `TypeError$E
◎
If chunk is not a BufferSource type, then throw a TypeError.
</li>
	<li>
%~buffer ~LET %ds の［
`解凍~形式$, `解凍~文脈$
］を用いて，
%~chunk を解凍した結果
◎
Let buffer be the result of decompressing chunk with ds’s format and context.＼
</li>
	<li>
~IF［
前~段は~errorした
］
⇒
~THROW `TypeError$E
◎
If this results in an error, then throw a TypeError.
</li>
	<li>
~IF［
%~buffer は空である
］
⇒
~RET
◎
If buffer is empty, return.
</li>
	<li>
<p>
%~buffer を 1 個~以上の空でない~pieceに分割した結果を成す
~EACH( %~piece )
に対し：
</p>
		<ol>
			<li>
%配列 ~LET %~piece を `Uint8Array$I へ変換した結果
</li>
			<li>
%ds の`形式変換$GTSに`~chunkを~enqueueする$TS( %配列 )
</li>
		</ol>
◎
Let arrays be the result of splitting buffer into one or more non-empty pieces and converting them into Uint8Arrays.
◎
For each Uint8Array array of arrays, enqueue array in ds’s transform.
</li>
</ol>
</div>

<div class="algo">
<p>
`解凍-用の書出nを~enqueueする@
~algoは、
入力 `ReadableStream$I ~objからの~dataの終端を取扱う。
それは、
所与の
( `DecompressionStream$I ~obj %ds )
に対し：
◎
The decompress flush and enqueue algorithm, which handles the end of data from the input ReadableStream object, given a DecompressionStream object ds, runs these steps:
</p>
<ol>
	<li>
%~buffer ~LET %ds の［
`解凍~形式$, `解凍~文脈$
］を用いて, および
`the finish flag^en
【これが具体的に どう働くかは指定されていない】
を伴わせて，
空な入力を解凍した結果
◎
Let buffer be the result of decompressing an empty input with ds’s format and context, with the finish flag.
</li>
	<li>
~IF［
圧縮された入力の終端に達していない
【この条件が精確にどう定義されるのかは述べられていない。】
］
⇒
~THROW `TypeError$E
◎
If the end of the compressed input has not been reached, then throw a TypeError.
</li>
	<li>
~IF［
%~buffer は空である
］
⇒
~RET
◎
If buffer is empty, return.
</li>
	<li>
<p>
%~buffer を 1 個~以上の空でない~pieceに分割した結果を成す
~EACH( %~piece )
に対し：
</p>
		<ol>
			<li>
%配列 ~LET %~piece を `Uint8Array$I へ変換した結果
</li>
			<li>
%ds の`形式変換$GTSに`~chunkを~enqueueする$TS( %配列 )
</li>
		</ol>
◎
Let arrays be the result of splitting buffer into one or more non-empty pieces and converting them into Uint8Arrays.
◎
For each Uint8Array array of arrays, enqueue array in ds’s transform.
</li>
</ol>
</div>

	</section>
	<section id="privacy-security">
<h2 title="Privacy and security considerations">6. ~privacy／~securityの考慮点</h2>

<p>
この~APIは、
~web~platformに新たな特権を何も追加しない。
◎
The API doesn’t add any new privileges to the web platform.
</p>

<p>
しかしながら，~web開発者は、［
攻撃者が~dataの長さを取得できる状況
］に注意を払う必要がある。
そのような状況においては、
~dataを成す内容を攻撃者が推測-可能になり得るので。
◎
However, web developers have to pay attention to the situation when attackers can get the length of the data. If so, they may be able to guess the contents of the data.
</p>

	</section>
	<section id="examples">
<h2 title="Examples">7. 例</h2>

		<section>
<h3 title="Gzip-compress a stream">7.1. ~streamを `gzip^l で圧縮する</h3>

<div class="example">
<pre class="lang-js">
const %compressedReadableStream
    = %inputReadableStream.pipeThrough(new CompressionStream('gzip'));
</pre>
</div>

		</section>
		<section>
<h3 title="Deflate-compress an ArrayBuffer to a Uint8Array">7.2. `ArrayBuffer$I を `Uint8Array$I へ `deflate^l で圧縮する</h3>

<div class="example">
<pre class="lang-js">
async function compressArrayBuffer(%input) {
  const %cs = new CompressionStream('deflate');

  const %writer = %cs.writable.getWriter();
  %writer.write(%input);
  %writer.close();

  const %output = [];
  let %totalSize = 0;
  for (const %chunk of %cs.readable) {
    %output.push(%value);
    %totalSize += %value.byteLength;
  }

  const %concatenated = new Uint8Array(%totalSize);
  let %offset = 0;
  for (const %array of %output) {
    %concatenated.set(%array, %offset);
    %offset += %array.byteLength;
  }

  return %concatenated;
}
</pre>
</div>

		</section>
		<section>
<h3 title="Gzip-decompress a Blob to Blob">7.3. `Blob$I を `Blob$I へ `gzip^l で解凍する</h3>

<div class="example">
<pre class="lang-js">
function decompressBlob(%blob) {
  const %ds = new DecompressionStream('gzip');
  const %decompressionStream = %blob.stream().pipeThrough(%ds);
  return new Response(%decompressionStream).blob();
}
</pre>
</div>

		</section>
	</section>
	<section id="acknowledgments">
<h2 title="Acknowledgments">謝辞</h2>

<p>
次の方々からの~~貢献に感謝する：
</p>

`_acks1@

	</section>
	<section id="ipr">
<h2 title="Intellectual property rights">知的財産権</h2>

`_ipr1@

	</section>
</main></div>

<div hidden>

<div lang="en" id="_acks1">
<p>
Thanks to Canon Mukai, Domenic Denicola, and Yutaka Hirano, for their support.
</p>

<p>This standard is written by Adam Rice (<a href="https://google.com">Google</a>, <a href="mailto:ricea@chromium.org">ricea@chromium.org</a>).</p>

</div>

<div lang="en" id="_ipr1">

<div data-fill-with="ipr">This Living Standard was originally developed in the W3C WICG, where it was available under the <a href="https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document">W3C Software and Document License</a>.</div>

<p>Copyright © WHATWG (Apple, Google, Mozilla, Microsoft). This work is licensed under a <a href="https://creativecommons.org/licenses/by/4.0/" rel="license">Creative Commons Attribution 4.0
International License</a>. To the extent portions of it are incorporated into source code, such portions in the source code are licensed under the <a href="https://opensource.org/licenses/BSD-3-Clause" rel="license">BSD 3-Clause License</a> instead.</p>

<p>This is the Living Standard. Those interested in the patent-review version should view the <a href="/review-drafts/2024-10/">Living Standard Review Draft</a>.</p>

</div>

</div>