radash 安裝

npm

npm install radash

yarn

yarn add radash

pnpm

pnpm add radash

使用

ES6 模組

import { range, tryit } from 'radash'

// 使用 range 函數
for (const i of range(0, 4)) {
  console.log(i) // 0, 1, 2, 3, 4
}

// 使用 tryit 函數
const [err, response] = await tryit(api.gods.create)({ name: 'Ra' })
if (err) {
  throw new Error('Your god is weak and could not be created')
}

CommonJS

const { range, tryit } = require('radash')

// 使用 range 函數
for (const i of range(0, 4)) {
  console.log(i) // 0, 1, 2, 3, 4
}

// 使用 tryit 函數
const [err, response] = await tryit(api.gods.create)({ name: 'Ra' })
if (err) {
  throw new Error('Your god is weak and could not be created')
}

瀏覽器使用

CDN

<script src="https://unpkg.com/radash@latest/dist/index.umd.js"></script>
<script>
  const { range, tryit } = window.radash
  
  // 使用函數
  for (const i of range(0, 4)) {
    console.log(i) // 0, 1, 2, 3, 4
  }
</script>

ES6 模組 (CDN)

<script type="module">
  import { range, tryit } from 'https://unpkg.com/radash@latest/dist/index.esm.js'
  
  // 使用函數
  for (const i of range(0, 4)) {
    console.log(i) // 0, 1, 2, 3, 4
  }
</script>

TypeScript 支持

Radash 完全支持 TypeScript，所有函數都有完整的類型定義。

import { range, tryit, select } from 'radash'

// 類型安全的 range 函數
const numbers: number[] = Array.from(range(0, 10))

// 類型安全的 tryit 函數
const [err, result] = await tryit(async () => {
  return await fetch('/api/data')
})

// 類型安全的 select 函數
const users = [
  { id: 1, name: 'Alice', age: 25 },
  { id: 2, name: 'Bob', age: 30 },
  { id: 3, name: 'Charlie', age: 35 }
]

const adultUsers = select(users, 
  user => ({ ...user, isAdult: true }),
  user => user.age >= 18
)

環境要求

• Node.js >= 14.0.0
• 支持 ES6 模組的現代瀏覽器

快速開始

安裝完成後，你可以立即開始使用 Radash 的強大功能：

import { range, tryit, select, objectify } from 'radash'

// 1. 使用 range 進行迭代
for (const i of range(0, 10, 2)) {
  console.log(i) // 0, 2, 4, 6, 8, 10
}

// 2. 使用 tryit 進行錯誤處理
const [err, data] = await tryit(fetch)('/api/users')
if (err) {
  console.error('Failed to fetch users:', err)
  return
}

// 3. 使用 select 進行數據轉換和過濾
const users = await data.json()
const activeUsers = select(users,
  user => ({ ...user, status: 'active' }),
  user => user.isActive
)

// 4. 使用 objectify 將數組轉換為對象
const usersById = objectify(users, 
  user => user.id,
  user => user.name
)

Radash 提供了 100+ 個實用函數，涵蓋了數組、對象、字符串、數字、異步操作等各個方面，幫助你更高效地編寫 JavaScript/TypeScript 代碼。