我们的原则

设计以人为本

我们的目标是设计一个符合人体工程学、合理且高效的工作框架，即使是初学者也能轻松使用。

设计以避免不必要的复杂性，并为您简化类型复杂性，以便您专注于构建。

一个感觉就像 JavaScript 的框架

typescript

import { Elysia, file } from 'elysia'

new Elysia()
	.get('/', 'Hello World')
	.get('/image', file('mika.webp'))
	.get('/stream', function* () {
		yield 'Hello'
		yield 'World'
	})
	.ws('/realtime', {
		message(ws, message) {
			ws.send('got:' + message)
		}
	})
	.listen(3000)

更加先进的类型安全

Bring your own Validator

With support for Standard Schema

Elysia offers a robust built-in validation, but you can also bring your favorite validator, like Zod, Valibot, ArkType, Effect , and more

With seamless support for type inference, and OpenAPI. You will feels right at home.

import { Elysia
, t
 } from 'elysia'


new Elysia
()
	// Try hover body  ↓
	.post
('/user', ({ body
 }) => body
, {
		body
: t
.Object
({
			name
: t
.Literal
('SaltyAom'),
			age
: t
.Number
(),
			friends
: t
.Array
(t
.String
())
		})
	})

import { Elysia
 } from 'elysia'
import { z
 } from 'zod'

new Elysia
()
	// Try hover body  ↓
	.post
('/user', ({ body
 }) => body
, {
		body
: z
.object
({
			name
: z
.literal
('SaltyAom'),
			age
: z
.number
(),
			friends
: z
.array
(z
.string
())
		})
	})

import { Elysia
 } from 'elysia'
import * as v
 from 'valibot'

new Elysia
()
	// Try hover body  ↓
	.post
('/user', ({ body
 }) => body
, {
		body
: v
.object
({
			name
: v
.literal
('SaltyAom'),
			age
: v
.number
(),
			friends
: v
.array
(v
.string
())
		})
	})

import { Elysia
 } from 'elysia'
import { type
 } from 'arktype'

new Elysia
()
	// Try hover body  ↓
	.post
('/user', ({ body
 }) => body
, {
		body
: type
({
			name
: '"Elysia"',
			age
: 'number',
			friends
: 'string[]'
		})
	})

import { Elysia
 } from 'elysia'
import { Schema
 } from 'effect'

new Elysia
()
	// Try hover body  ↓
	.post
('/user', ({ body
 }) => body
, {
		body
: Schema
.standardSchemaV1
(
			Schema
.Struct
({
				name
: Schema
.Literal
('Elysia'),
				age
: Schema
.Number
,
				friends
: Schema
.Array
(Schema
.String
)
			})
		)
	})

向您的实际 API 打招呼，使用 OpenAPI

我们认真对待 OpenAPI 文档

与 OpenAPI 模式深度集成
Elysia 可以开箱即用地生成 API 文档。

Elysia deeply integrate with OpenAPI to generate beautiful API documentation out of the box
With Elysia OpenAPI Type Gen. Elysia use TypeScript type, and turn it into OpenAPI schema automatically
You can try out the API directly from the API documentation
Describe your API with a built-in schema, or bring your own validator that support OpenAPI document
Model is seamlessly supported out of the box, and integrated with runtime to ensure accuracy

Item 1 of 5

OpenAPI features, all in 1 line

Just 1 line of code, you get a full-fledge API documentation effortlessly

And with OpenAPI Type Gen, Elysia can turn TypeScript type into an API documentation (like FastAPI but from TypeScript type)

OpenAPIWith Type Gen

typescript

import { Elysia } from 'elysia'
import { openapi } from '@elysiajs/openapi'

new Elysia()
	.use(openapi())
	.listen(3000)

typescript

import { Elysia } from 'elysia'
import { openapi, fromTypes } from '@elysiajs/openapi'

export const app = new Elysia()
	.use(
		openapi({
			references: fromTypes()
		})
	)

11.88ms

POST /character/:id/chat

Playback

Request

Validation

Transaction

Upload

Sync

对于 DevOps

OpenTelemetry

Elysia 原生支持 OpenTelemetry。监控功能内置，因此您可以轻松监控您的服务，无论平台如何。

typescript

import { treaty
 } from '@elysiajs/eden'
import type { App
 } from './server'

const api
 = treaty
<App
>('api.elysiajs.com')

const { data
 } = await api
.profile
.patch
({
    age
: 21
})

对于前端

端到端类型安全

像 tRPC 一样，Elysia 提供从后端到前端的类型安全，而无需代码生成。前端和后端之间的交互在编译时和运行时都经过类型检查。

21x

比 Express 更快

6x

比 Fastify 更快

Elysia Bun
2,454,631 reqs/s
Gin Go
676,019
Spring Java
506,087
Fastify Node
415,600
Express Node
113,117
Nest Node
105,064

以每秒请求次数进行测量。数据来源于官方 TechEmpower 基准测试第 22 轮（2023-10-17）的 PlainText 结果。

充满信心地进行测试

类型安全带有自动完成功能

Elysia 提供了一个类型安全层，用于与您的服务器进行交互和测试，涵盖从路由到参数的各个环节。

借助自动补全功能，您可以轻松为服务器编写测试，无需任何繁琐操作。

typescript

import { treaty
 } from '@elysiajs/eden'
import { app
 } from './index'
import { test
, expect
 } from 'bun:test'

const server
 = treaty
(app
)

test
('应处理重复用户', async () => {
	const { error
 } = await server
.user
.put
({Argument of type '{ username: string; }' is not assignable to parameter of type '{ username: string; password: string; }'.
  Property 'password' is missing in type '{ username: string; }' but required in type '{ username: string; password: string; }'.
	    username
: 'mika',
	})

	expect
(error
?.value
).toEqual
({
		success
: false,
		message
: '用户名已被占用'
	})
})

人们怎么说

Elysia

Aqueel

@AqueelMiq

Jetfuel on bun at X! @shlomiatar who built the framework has an eye for picking the right tools for the job.

Shlomi Atar

@shlomiatar

also a shoutout to @saltyAom and the phenomenal Elysia js that is powering our server driven UI. Incredible work.

htmx.org

@htmx_org

htmx works great w/ @bunjavascript, @elysiaJS and @tursodatabase btw

Marc Laventure

@MarcLaventure

both engineering+monetary contributions are paramount for OSS we proudly sponsor dozens of projects: @elysiaJS @LitestarAPI @honojs @daveshanley @kevin_jahns @MarijnJH & help maintain repos+contribute to OSS at blistering cadence. it's @scalar's ethos to be a catalyst for OSS

Jarred Sumner

@jarredsumner

You can use Express with Bun, but often we see people using Elysia, Hono, or Bun.serve() directly.

Runyasak Ch. 💚

@runyasak

Started using @elysiaJS to create a Discord Bot and found the type system beautifully easy. DX is fantastic and coding is fun! Use @DrizzleORM with PostgreSQL. So much easier than I've used before. ElysiaJS has proved to me that great performance and DX can live together. 😎

Herrington Darkholme

@hd_nvim

Was introduced to @elysiaJS today and it looks pretty solid. end-to-end type safety/guard/swapper are killer features of the modern web! (and it's fast)

scalar.com

@scalar

so excited to be part of the amazing @elysiaJS community!

José Donato 🦋

@josedonato__

handling tables with ~350k rows like it's nothing. Working on allowing @ag_grid server side row model when connecting a custom backend to @openbb_finance Terminal Pro. Backend in @elysiaJS + @bunjsproject.

Bewinxed

@Bewinxed

Elysia single handedly carrying js backends I have been using it almost exclusively for all my projects

MikroORM

@MikroORM

I've been playing a bit with @bunjavascript and @elysiaJS, need to do a few more tweaks before the release, but next version should work more natively with bun when it comes to TS support detection, e.g. the CLI works without ts-node installed.

由你实现

Elysia 不属于任何组织，由志愿者和社区驱动。 Elysia 的实现得益于这些出色的赞助商。

Thank you for making Elysia possible

We can only develop Elysia full-time thanks to your supports.

With love from our community

人体工程学框架

具有 TypeScript 端到端的类型安全，统一的类型系统和出色的开发人员体验。由 Bun 提供加速支持。

第一个生产准备就绪
以及最受欢迎的 Bun 框架

Trusted by team at

我们的原则

设计以人为本

更加先进的类型安全

Bring your own Validator

With support for Standard Schema

向您的实际 API 打招呼，使用 OpenAPI

OpenAPI features, all in 1 line

对于 DevOps

OpenTelemetry

对于前端

端到端类型安全

21x

6x

Elysia Bun

Gin Go

Spring Java

Fastify Node

Express Node

Nest Node

充满信心地进行测试

类型安全带有自动完成功能

人们怎么说

由你实现

Elysia

Ergonomic Framework for Humans

Speed

Type Safety

Developer Experience

OpenAPI Support

第一个生产准备就绪以及最受欢迎的 Bun 框架

Trusted by team at

更加先进的 类型安全

OpenAPI features, all in 1 line

Elysia Bun

Gin Go

Spring Java

Fastify Node

Express Node

Nest Node

人们怎么说

由你实现

第一个生产准备就绪
以及最受欢迎的 Bun 框架

更加先进的类型安全