Class CborSequenceEncoderStream

A TransformStream that encodes a ReadableStream into CBOR format sequence. RFC 8949 - Concise Binary Object Representation (CBOR)

import { encodeBase64Url } from "@std/encoding";
import {
CborArrayDecodedStream,
CborArrayEncoderStream,
CborByteDecodedStream,
CborByteEncoderStream,
CborMapDecodedStream,
CborMapEncoderStream,
type CborStreamOutput,
CborSequenceDecoderStream,
CborSequenceEncoderStream,
CborTag,
CborTextDecodedStream,
CborTextEncoderStream,
} from "@std/cbor";

const rawMessage = [
undefined,
null,
true,
false,
3.14,
5,
2n ** 32n,
"Hello World",
new Uint8Array(25),
new Date(),
new CborTag(33, encodeBase64Url(new Uint8Array(7))),
["cake", "carrot"],
{ a: 3, b: "d" },
CborByteEncoderStream.from([new Uint8Array(7)]),
CborTextEncoderStream.from(["Bye!"]),
CborArrayEncoderStream.from([
"Hey!",
CborByteEncoderStream.from([new Uint8Array(18)]),
]),
CborMapEncoderStream.from([
["a", 0],
["b", "potato"],
]),
];

async function logValue(value: CborStreamOutput) {
if (
value instanceof CborByteDecodedStream ||
value instanceof CborTextDecodedStream
) {
for await (const x of value) console.log(x);
} else if (value instanceof CborArrayDecodedStream) {
for await (const x of value) logValue(x);
} else if (value instanceof CborMapDecodedStream) {
for await (const [k, v] of value) {
console.log(k);
logValue(v);
}
} else if (value instanceof CborTag) {
console.log(value);
logValue(value.tagContent);
} else console.log(value);
}

for await (
const value of ReadableStream.from(rawMessage)
.pipeThrough(new CborSequenceEncoderStream())
.pipeThrough(new CborSequenceDecoderStream())
) {
logValue(value);
}
Implements

Constructors

Accessors

Methods

Constructors

Accessors

  • get readable(): ReadableStream<Uint8Array>
  • The ReadableStream associated with the instance, which provides the encoded CBOR data as Uint8Array chunks.

    Returns ReadableStream<Uint8Array>

    A ReadableStream.

    import { encodeBase64Url } from "@std/encoding";
    import {
    CborArrayDecodedStream,
    CborArrayEncoderStream,
    CborByteDecodedStream,
    CborByteEncoderStream,
    CborMapDecodedStream,
    CborMapEncoderStream,
    type CborStreamOutput,
    CborSequenceDecoderStream,
    CborSequenceEncoderStream,
    CborTag,
    CborTextDecodedStream,
    CborTextEncoderStream,
    } from "@std/cbor";

    const rawMessage = [
    undefined,
    null,
    true,
    false,
    3.14,
    5,
    2n ** 32n,
    "Hello World",
    new Uint8Array(25),
    new Date(),
    new CborTag(33, encodeBase64Url(new Uint8Array(7))),
    ["cake", "carrot"],
    { a: 3, b: "d" },
    CborByteEncoderStream.from([new Uint8Array(7)]),
    CborTextEncoderStream.from(["Bye!"]),
    CborArrayEncoderStream.from([
    "Hey!",
    CborByteEncoderStream.from([new Uint8Array(18)]),
    ]),
    CborMapEncoderStream.from([
    ["a", 0],
    ["b", "potato"],
    ]),
    ];

    async function logValue(value: CborStreamOutput) {
    if (
    value instanceof CborByteDecodedStream ||
    value instanceof CborTextDecodedStream
    ) {
    for await (const x of value) console.log(x);
    } else if (value instanceof CborArrayDecodedStream) {
    for await (const x of value) logValue(x);
    } else if (value instanceof CborMapDecodedStream) {
    for await (const [k, v] of value) {
    console.log(k);
    logValue(v);
    }
    } else if (value instanceof CborTag) {
    console.log(value);
    logValue(value.tagContent);
    } else console.log(value);
    }

    for await (
    const value of ReadableStream.from(rawMessage)
    .pipeThrough(new CborSequenceEncoderStream())
    .pipeThrough(new CborSequenceDecoderStream())
    ) {
    logValue(value);
    }
  • get writable(): WritableStream<CborStreamInput>
  • The WritableStream associated with the instance, which accepts CborStreamInput chunks to be encoded into CBOR format.

    Returns WritableStream<CborStreamInput>

    A WritableStream.

    import { encodeBase64Url } from "@std/encoding";
    import {
    CborArrayDecodedStream,
    CborArrayEncoderStream,
    CborByteDecodedStream,
    CborByteEncoderStream,
    CborMapDecodedStream,
    CborMapEncoderStream,
    type CborStreamOutput,
    CborSequenceDecoderStream,
    CborSequenceEncoderStream,
    CborTag,
    CborTextDecodedStream,
    CborTextEncoderStream,
    } from "@std/cbor";

    const rawMessage = [
    undefined,
    null,
    true,
    false,
    3.14,
    5,
    2n ** 32n,
    "Hello World",
    new Uint8Array(25),
    new Date(),
    new CborTag(33, encodeBase64Url(new Uint8Array(7))),
    ["cake", "carrot"],
    { a: 3, b: "d" },
    CborByteEncoderStream.from([new Uint8Array(7)]),
    CborTextEncoderStream.from(["Bye!"]),
    CborArrayEncoderStream.from([
    "Hey!",
    CborByteEncoderStream.from([new Uint8Array(18)]),
    ]),
    CborMapEncoderStream.from([
    ["a", 0],
    ["b", "potato"],
    ]),
    ];

    async function logValue(value: CborStreamOutput) {
    if (
    value instanceof CborByteDecodedStream ||
    value instanceof CborTextDecodedStream
    ) {
    for await (const x of value) console.log(x);
    } else if (value instanceof CborArrayDecodedStream) {
    for await (const x of value) logValue(x);
    } else if (value instanceof CborMapDecodedStream) {
    for await (const [k, v] of value) {
    console.log(k);
    logValue(v);
    }
    } else if (value instanceof CborTag) {
    console.log(value);
    logValue(value.tagContent);
    } else console.log(value);
    }

    for await (
    const value of ReadableStream.from(rawMessage)
    .pipeThrough(new CborSequenceEncoderStream())
    .pipeThrough(new CborSequenceDecoderStream())
    ) {
    logValue(value);
    }

Methods

  • Creates a CborSequenceEncoderStream instance from an iterable of CborStreamInput chunks.

    Parameters

    Returns CborSequenceEncoderStream

    A CborSequenceEncoderStream instance of the encoded data.

    import { encodeBase64Url } from "@std/encoding";
    import {
    CborArrayDecodedStream,
    CborArrayEncoderStream,
    CborByteDecodedStream,
    CborByteEncoderStream,
    CborMapDecodedStream,
    CborMapEncoderStream,
    type CborStreamOutput,
    CborSequenceDecoderStream,
    CborSequenceEncoderStream,
    CborTag,
    CborTextDecodedStream,
    CborTextEncoderStream,
    } from "@std/cbor";

    const rawMessage = [
    undefined,
    null,
    true,
    false,
    3.14,
    5,
    2n ** 32n,
    "Hello World",
    new Uint8Array(25),
    new Date(),
    new CborTag(33, encodeBase64Url(new Uint8Array(7))),
    ["cake", "carrot"],
    { a: 3, b: "d" },
    CborByteEncoderStream.from([new Uint8Array(7)]),
    CborTextEncoderStream.from(["Bye!"]),
    CborArrayEncoderStream.from([
    "Hey!",
    CborByteEncoderStream.from([new Uint8Array(18)]),
    ]),
    CborMapEncoderStream.from([
    ["a", 0],
    ["b", "potato"],
    ]),
    ];

    async function logValue(value: CborStreamOutput) {
    if (
    value instanceof CborByteDecodedStream ||
    value instanceof CborTextDecodedStream
    ) {
    for await (const x of value) console.log(x);
    } else if (value instanceof CborArrayDecodedStream) {
    for await (const x of value) logValue(x);
    } else if (value instanceof CborMapDecodedStream) {
    for await (const [k, v] of value) {
    console.log(k);
    logValue(v);
    }
    } else if (value instanceof CborTag) {
    console.log(value);
    logValue(value.tagContent);
    } else console.log(value);
    }

    for await (
    const value of CborSequenceEncoderStream.from(rawMessage)
    .readable
    .pipeThrough(new CborSequenceDecoderStream())
    ) {
    logValue(value);
    }