http2lite

Http2Lite

zero dependency tools for DIY http2 in node or browser (with a build tool that understands require)

TODO

• more documentation
• fix "code smells"
• put something meaningful into the readme
• build a simple default hpack context
• add an example (or two)
• fix generated API documentation

API

Table of Contents

• H2LSession
  • Parameters
  • writeFrame
    • Parameters
  • request
• H2LStream
  • Parameters
  • writeRequest
    • Parameters
• Request
  • Properties
• decodeRequest
  • Parameters
• encodeRequest
  • Parameters
• decodeFrameHeader
  • Parameters
• FrameHeader
  • Properties
• encodeFrameHeader
  • Parameters
• decodeFlags
  • Parameters
• Flags
  • Properties
• decodePriority
  • Parameters
• Priority
  • Properties
• encodePriority
  • Parameters
• alloc
  • Parameters
• allocUnsafe
  • Parameters
• readUInt8
  • Parameters
• readUInt24BE
  • Parameters
• readUInt32BE
  • Parameters
• writeUInt8
  • Parameters
• writeUInt24BE
  • Parameters
• writeUInt32BE
  • Parameters
• concat
  • Parameters

H2LSession

Extends Emitter

Muxes and demuxes

Parameters

• nextStreamId Number default is 1 for client, passing 2 would be for server (optional, default 1)

writeFrame

Emit any new http messages. Emit new streams when necessary.

Parameters

• frame Uint8Array partial and/or multiple encoded http messages

request

Returns H2LStream

H2LStream

Extends Emitter

Gateway for reading from and writing to virtual streams

Parameters

• h2LSession H2LSession
• streamId Number

writeRequest

Encode http-like request and mux it into the output stream

Parameters

• request

Request

Type: Object

Properties

• type Number
• streamId Number
• padLength Number
• payload Uint8Array
• bytesRead Number

decodeRequest

Parameters

• ui8a Uint8Array

Returns Request

encodeRequest

Parameters

• request Request

Returns Uint8Array

decodeFrameHeader

Parameters

• ui8a Uint8Array

Returns FrameHeader

FrameHeader

Type: Object

Properties

• streamId Number
• type Number
• length Number

encodeFrameHeader

Parameters

• frameHeader FrameHeader

Returns Uint8Array

decodeFlags

Parameters

• ui8 Number

Returns Flags

Flags

Type: Object

Properties

• endStream Boolean
• isAck Boolean
• endHeaders Boolean
• isPadded Boolean
• isPriority Boolean

decodePriority

Parameters

• ui8a Uint8Array

Returns Priority

Priority

Type: Object

Properties

• priority Number
• streamDependency Number
• isExclusive Boolean

encodePriority

Parameters

• priority Priority

Returns Uint8Array

alloc

Parameters

• size Number

Returns Uint8Array

allocUnsafe

Parameters

• size Number

Returns Uint8Array

readUInt8

Parameters

• ui8a Uint8Array
• offset Number

Returns Number

readUInt24BE

Parameters

• ui8a Uint8Array
• offset Number

Returns Number

readUInt32BE

Parameters

• ui8a Uint8Array
• offset Number

Returns Number

writeUInt8

Parameters

• ui8a Uint8Array
• value Number
• offset Number

writeUInt24BE

Parameters

• ui8a Uint8Array
• value Number
• offset Number

writeUInt32BE

Parameters

• ui8a Uint8Array
• value Number
• offset Number

concat

Parameters

• ui8as Array<Uint8Array>

Returns Uint8Array