Skip to main content
Module

x/cav/dom.ts

A server framework for Deno
Go to Latest
import * as cav from "https://deno.land/x/cav@0.2.0-alpha.7/dom.ts";

Classes

Error class for describing exceptions during HTTP processing.

Functions

f
$

Shorthand for document.querySelector. If a second parent node is provided, it will be searched instead of the document.

Shorthand for document.querySelectorAll. If a second parent node is provided, it will be searched instead of the document.

Creates a new Client function tied to a base URL, for triggering RPCs on a Cav server and deserializing the response. If the type parameter is a Cav Router or Endpoint, end-to-end type safety kicks in.

Filters out any non-string or empty string arguments and joins the rest to create a class list for an HTML element.

Deserializes a JSON value that was serialize()d back into the original input. An error will be thrown if a value was serialized with an unknown serializer.

Determines if the object is a plain object or not. This also checks for prototype poisoning; it returns false whenever the prototype of an input object was poisoned before JSON.parsing it.

Creates a new DocumentFragment using the provided HTML.

Normalizes a Parser into a ParserFunction.

Serializes a new Request, which can then be deserialized using unpack(). Only GET and POST requests are supported; the method used is automatically determined based on the presence of the body init option. Any headers specified on the init options will override the headers determined during serialization. The serializable input types can be extended with the serializers option.

Serializes a new Response, which can then be deserialized back into the input body using unpack(). Any headers specified on the init options will override the headers determined during serialization. The same applies for status and statusText. The serializable input types can be extended with the serializers option.

Serializes a value recursively until it's JSON-compatible. Serializers can be plugged in to extend the accepted types beyond what Cav supports by default. If a value isn't recognized by any of the provided or default serializers, an error will be thrown.

Constructs a Serializer. This simply returns the first argument, it's only used for type annotations.

Deserializes a Request generated with packRequest() back into the original request body. Any serializers specified during packing need to be specified here as well.

Wraps a WebSocket instance with added serialization functionality and E2E type support. If the input is a string, the wrapped WebSocket will be created with the given URL.

Interfaces

Arguments for the Client functions.

A server endpoint handler can use this Request type to ferry type information to the client about what argument types are acceptable and what the result will be into.

Init options for constructing HttpErrors, which can expose arbitrary data and status codes during de/serialization.

Initializer options when creating a Request with packRequest().

A function that parses data. If data is not shaped as expected, an error should be thrown.

An object with a ParserFunction as its "parse" property. Zod compatible.

A server router handler can use this Request type to ferry type information to the client about what routes exist and what data they accept/return. The client uses the RouterShape to infer which property accesses are valid and what their response type will be.

The shape of a RouterRequest, mapping allowed routes to their handlers.

Interface for serializing and deserializing arbitrary non-JSON primitive values into JSON.

Options for the unpack() function.

Isomorphic WebSocket interface with JSON serialization and typed messages.

Initializer options for the webSocket() function.

Type Aliases

Type alias representing a Serializer with any input or output type. Useful for type constraints.

Client function for making RPC requests to a Cav server.

The shape of an EndpointRequest, holding the type information needed to calculate the allowable ClientArgs.

Generic handler type for server-defined Request handlers.

An object or function responsible for parsing data or throwing errors if the data isn't shaped as expected. These can either be functions with a single data argument that return the parsed data or an object with a parse(data): unknown function that does the same. Parsers can be asynchronous.

Extracts the input type of a given Parser.

Extracts the output type of a given Parser.

A group of named Serializer objects. Serializer keys are used to tag serialized values on the output JSON, which is required in order to correctly deserialize the value on the other side.

Listener for a Socket's "close" event.

Listener for a web socket's "error" event.

Listener for a web socket's "message" event. The message is deserialized from the event data.

Listener for a Socket's "open" event.