Cross

A tiny and strong framework for deno web application.

Get started

import { Cross } from "https://deno.land/x/cross/mod.ts";

Shortcut mode

1. Handles all get requests.

Cross(ctx => {
    return ctx.path;
});

1. Creates quick routes.

import { Cross, get, post } from "https://deno.land/x/cross/mod.ts";

Cross(
    get("/:user", ctx => {
        return ctx.params;
    }),
    post("/:user", ctx => {
        return ctx.params;
    })
);

1. Starts with options.

import { Cross, get, post } from "https://deno.land/x/cross/mod.ts";

Cross({
        assets: "/static/dir/path",
        port: 3000
    }
    get("/:user", ctx => {
        return ctx.params;
    }),
    post("/:user", ctx => {
        return ctx.params;
    })
);

Note that features such as plugins, middlewares, and unified error handling cannot be used in shortcut mode, and you must solve them in other ways.

Decorator mode

If no route is set in the startup parameters, the framework will automatically switch to decorator mode. The only difference in performance between the decorator mode and the shortcut mode is that the former needs to scan and load all decorators at startup, it is basically the same in runtime.

// index.ts
import { Cross } from "https://deno.land/x/cross/mod.ts";

// If no options, the empty {} is necessary
Cross({})

1. Controller

// controller.ts
import { Controller, Get, Context } from "https://deno.land/x/cross/mod.ts";

@Controller("/prefix")
export class MyController {
    @Get("/:user")
    user(ctx: Context) {
        return ctx.params;
    }
}

2. Middleware

You can add middleware decorator on any class method, including controllers. The role of the middleware parameter is to set the execution priority.

// middleware.ts
import { Middleware, Context } from "https://deno.land/x/cross/mod.ts";

export class MyMiddleware {
    @Middleware(1)
    cors(ctx: Context) {
        // todo something
    }
    @Middleware(2)
    auth(ctx: Context) {
        // todo something
    }
}

3. Plugin

Plugin decorators can only be added to classes, and the parameter is the name bound to the context.

// plugin.ts
import { Plugin } from "https://deno.land/x/cross/mod.ts";

@Plugin("redis")
export class Redis {
    constructor() {
        // connect to redis server and create a client
    }
    get(key) {
        // todo something
    }
    set(key, value) {
        // todo something
    }
}

Then you can use redis object as singleton instance in any controllers with ctx.redis.

4. ErrorHandlder

If an error handler decorator is defined, all errors within the framework will be handled by it. Like middleware, you can define it in any class method, but only once. This decorator has no parameters.

// error.ts
import { ErrorHandler, Context } from "https://deno.land/x/cross/mod.ts";

export class AnyClass {
    @ErrorHandler
    error(ctx: Context) {
        console.log(ctx.error)
    }
}

API Reference

Instance

To start the web service, you simply call one method Cross({}). Note that not new an instance.

Options

Shortcuts

The shortcut methods including all,get,post,put,del,patch,head,opt, and all methods have the same parameters.

Parameters

Decorators

Context

Context is an instance passed to controllers, middlewares and error handler, it contains properties and methods related to requests and responses.

Properties

Body parsing methods: text(), json(), form(), blob(), buffer().

Methods