content-range-parser

HTTP Content-Range header field parser.

Compliant with RFC 9110, 14.4. Content-Range.

Deserialization

Parses string into ContentRange.

1import { parseContentRange } from "https://deno.land/x/content_range_parser@$VERSION/parse.ts";
2import { assertEquals } from "https://deno.land/std/testing/asserts.ts";
3
4assertEquals(parseContentRange("bytes 0-100/1000"), {
5  rangeUnit: "bytes",
6  firstPos: 0,
7  lastPos: 100,
8  completeLength: 1000,
9});
10assertEquals(parseContentRange("bytes 100-200/*"), {
11  rangeUnit: "bytes",
12  firstPos: 100,
13  lastPos: 200,
14  completeLength: undefined,
15});
16assertEquals(parseContentRange("bytes */1000"), {
17  rangeUnit: "bytes",
18  completeLength: 1000,
19});

Throwing error

If input is invalid, the following error occurs:

• Syntax error
• Semantic error

Syntax error

Throws SyntaxError if the input is invalid <Content-Range> syntax.

1import { parseContentRange } from "https://deno.land/x/content_range_parser@$VERSION/parse.ts";
2import { assertThrows } from "https://deno.land/std/testing/asserts.ts";
3
4assertThrows(() => parseContentRange("<invalid>"));

Semantic error

Throw Error if the input contains invalid semantics.

Invalid semantics are indicated as follows:

A Content-Range field value is invalid if it contains a range-resp that has a last-pos value less than its first-pos value, or a complete-length value less than or equal to its last-pos value. The recipient of an invalid Content-Range MUST NOT attempt to recombine the received content with a stored representation.

1import { parseContentRange } from "https://deno.land/x/content_range_parser@$VERSION/parse.ts";
2import { assertThrows } from "https://deno.land/std/testing/asserts.ts";
3
4assertThrows(() => parseContentRange("bytes 100-0/*"));
5assertThrows(() => parseContentRange("bytes 100-200/0"));

Serialization

Serialize ContentRange into string.

1import { stringifyContentRange } from "https://deno.land/x/content_range_parser@$VERSION/stringify.ts";
2import { assertEquals } from "https://deno.land/std/testing/asserts.ts";
3
4assertEquals(
5  stringifyContentRange({
6    rangeUnit: "bytes",
7    firstPos: 0,
8    lastPos: 100,
9    completeLength: 1000,
10  }),
11  "bytes 0-100/1000",
12);
13assertEquals(
14  stringifyContentRange({
15    rangeUnit: "bytes",
16    firstPos: 100,
17    lastPos: 200,
18    completeLength: undefined,
19  }),
20  "bytes 100-200/*",
21);
22assertEquals(
23  stringifyContentRange({ rangeUnit: "bytes", completeLength: 1000 }),
24  "bytes */1000",
25);

Throwing error

Throws TypeError if ContentRange contains invalid value.

1import { stringifyContentRange } from "https://deno.land/x/content_range_parser@$VERSION/stringify.ts";
2import { assertThrows } from "https://deno.land/std/testing/asserts.ts";
3
4assertThrows(() =>
5  stringifyContentRange({ rangeUnit: "<range-unit>", completeLength: NaN })
6);

then, semantic errors are also checked.

1import { stringifyContentRange } from "https://deno.land/x/content_range_parser@$VERSION/stringify.ts";
2import { assertThrows } from "https://deno.land/std/testing/asserts.ts";
3
4assertThrows(() =>
5  stringifyContentRange({
6    rangeUnit: "<range-unit>",
7    firstPos: 1,
8    lastPos: 0, // firstPos <= lastPos
9    completeLength: undefined,
10  })
11);
12assertThrows(() =>
13  stringifyContentRange({
14    rangeUnit: "<range-unit>",
15    firstPos: 0,
16    lastPos: 100,
17    completeLength: 0, // lastPos < completeLength
18  })
19);

Content Range

ContentRange is a structured object for Content-Range header.

Each field name is from camel Case of ABNF definition name.

Name	Type	Description
rangeUnit	string	Representation of <range-unit>.

and

<range-resp>:

Name	Type	Description
firstPost	number	Representation of <first-pos>.
lastPos	number	Representation of <last-pos>.
completeLength	number | undefined	Representation of <unsatisfied-range>.

or

<unsatisfied-range>:

Name	Type	Description
completeLength	number	Representation of <unsatisfied-range>

Utilities

It provides utilities.

isRangeResp

Whether the input is RangeResp or not.

1import {
2  type ContentRange,
3  isRangeResp,
4} from "https://deno.land/x/content_range_parser@$VERSION/mod.ts";
5import { assert } from "https://deno.land/std/testing/asserts.ts";
6
7declare const contentRange: ContentRange;
8assert(isRangeResp(contentRange));

isUnsatisfiedRange

Whether the input is UnsatisfiedRange or not.

1import {
2  type ContentRange,
3  isUnsatisfiedRange,
4} from "https://deno.land/x/content_range_parser@$VERSION/mod.ts";
5import { assert } from "https://deno.land/std/testing/asserts.ts";
6
7declare const contentRange: ContentRange;
8assert(isUnsatisfiedRange(contentRange));

API

All APIs can be found in the deno doc.

License

Copyright © 2023-present httpland.

Released under the MIT license