辅助函数

import string from '@adonisjs/core/helpers/string'

string.truncate('This is a long sentence', 10)
// This is a...

string.truncate('This is a long sentence', 10, { suffix: '...' })
// This is a...

// 同时包含后缀长度
string.truncate('This is a long sentence', 10, {
  suffix: '...',
  completeWords: true
})

string.slug('Hello world')
// hello-world

string.slug('Hello world', { replacement: '_' })
// hello_world

string.sentence('hello world')
// Hello world

string.title('hello world')
// Hello World

string.plural('box')
// boxes

string.plural('box', 2)
// boxes

string.plural('box', 1)
// box

import string from '@adonisjs/core/helpers/string'

string.singular('tests')
// test

import string from '@adonisjs/core/helpers/string'

string.isSingular('test') // true

import string from '@adonisjs/core/helpers/string'

string.camelCase('user_name') // userName

import string from '@adonisjs/core/helpers/string'

string.capitalCase('helloWorld') // Hello World

import string from '@adonisjs/core/helpers/string'

string.dashCase('helloWorld') // hello-world

string.dashCase('helloWorld', { capitalize: true }) // Hello-World

import string from '@adonisjs/core/helpers/string'

string.dotCase('helloWorld') // hello.World

string.dotCase('helloWorld', { lowerCase: true }) // hello.world

import string from '@adonisjs/core/helpers/string'

string.noCase('helloWorld') // hello world

import string from '@adonisjs/core/helpers/string'

string.pascalCase('user team') // UserTeam

import string from '@adonisjs/core/helpers/string'

string.sentenceCase('getting_started-with-adonisjs')
// Getting started with adonisjs

import string from '@adonisjs/core/helpers/string'

string.snakeCase('user team') // user_team

import string from '@adonisjs/core/helpers/string'

string.titleCase('small word ends on')
// Small Word Ends On

import string from '@adonisjs/core/helpers/string'

string.random(32)
// 8mejfWWbXbry8Rh7u8MW3o-6dxd80Thk

import string from '@adonisjs/core/helpers/string'

string.sentence(['routes', 'controllers', 'middleware'])
// routes, controllers, and middleware

string.sentence(['routes', 'controllers', 'middleware'], {
  lastSeparator: ', or ',
})

string.sentence(['routes', 'controllers'])
// routes and controllers

string.sentence(['routes', 'controllers'], {
  pairSeparator: ', and ',
})
// routes, and controllers

import string from '@adonisjs/core/helpers/string'

string.condenseWhitespace('hello  world')
// hello world

string.condenseWhitespace('  hello  world  ')
// hello world

import string from '@adonisjs/core/helpers/string'

string.seconds.parse('10h') // 36000
string.seconds.parse('1 day') // 86400

string.seconds.parse(180) // 180

string.seconds.format(36000) // 10h
string.seconds.format(36000, true) // 10 hours

import string from '@adonisjs/core/helpers/string'

string.milliseconds.parse('1 h') // 3.6e6
string.milliseconds.parse('1 day') // 8.64e7

string.milliseconds.parse(180) // 180

string.milliseconds.format(3.6e6) // 1h
string.milliseconds.format(3.6e6, true) // 1 hour

import string from '@adonisjs/core/helpers/string'

string.bytes.parse('1KB') // 1024
string.bytes.parse('1MB') // 1048576

string.bytes.parse(1024) // 1024

string.bytes.format(1048576) // 1MB
string.bytes.format(1024 * 1024 * 1000) // 1000MB
string.bytes.format(1024 * 1024 * 1000, { thousandsSeparator: ',' }) // 1,000MB

import string from '@adonisjs/core/helpers/string'

string.ordinal(1) // 1st
string.ordinal(2) // '2nd'
string.ordinal(3) // '3rd'
string.ordinal(4) // '4th'

string.ordinal(23) // '23rd'
string.ordinal(24) // '24th'

import { safeParse } from '@adonisjs/core/helpers'

safeParse('{"foo": "bar"}') // { foo: 'bar' }
safeParse('invalid json', { foo: 'bar' }) // { foo: 'bar' }

import { base64 } from '@adonisjs/core/helpers'

base64.encode('hello world')
// aGVsbG8gd29ybGQ=

base64.decode('aGVsbG8gd29ybGQ=')
// hello world

base64.urlEncode('hello world')
// aGVsbG8gd29ybGQ

base64.urlDecode('aGVsbG8gd29ybGQ')
// hello world

import { slash } from '@adonisjs/core/helpers'

slash('foo\\bar') // foo/bar

import { isAssertionError } from '@adonisjs/core/helpers'

try {
  assert.equal(1, 2)
} catch (error) {
  if (isAssertionError(error)) {
    // handle error
  }
}

import { fsReadAll } from '@adonisjs/core/helpers'

const files = await fsReadAll(new URL('./config', import.meta.url), { pathType: 'url' })
await Promise.all(files.map((file) => import(file)))

type Options = {
  ignoreMissingRoot?: boolean
  filter?: (filePath: string, index: number) => boolean
  sort?: (current: string, next: string) => number
  pathType?: 'relative' | 'unixRelative' | 'absolute' | 'unixAbsolute' | 'url'
}

const options: Partial<Options> = {}
await fsReadAll(location, options)

import { fsImportAll } from '@adonisjs/core/helpers'

const collection = await fsImportAll(new URL('./config', import.meta.url))
console.log(collection)

type Options = {
  ignoreMissingRoot?: boolean
  filter?: (filePath: string, index: number) => boolean
  sort?: (current: string, next: string) => number
  transformKeys? (keys: string[]) => string[]
}

const options: Partial<Options> = {}
await fsImportAll(location, options)

import string from '@adonisjs/core/helpers/string'

const value = string
  .create('userController')
  .removeSuffix('controller') // user
  .plural() // users
  .snakeCase() // users
  .suffix('_controller') // users_controller
  .ext('ts') // users_controller.ts
  .toString()

import { MessageBuilder } from '@adonisjs/core/helpers'

const builder = new MessageBuilder()
const encoded = builder.build(
  {
    token: string.random(32),
  },
  '1 hour',
  'email_verification'
)

/**
 * {
 *   "message": {
 *    "token":"GZhbeG5TvgA-7JCg5y4wOBB1qHIRtX6q"
 *   },
 *   "purpose":"email_verification",
 *   "expiryDate":"2022-10-03T04:07:13.860Z"
 * }
 */

import { MessageBuilder } from '@adonisjs/core/helpers'

const builder = new MessageBuilder()
const decoded = builder.verify(value, 'email_verification')
if (!decoded) {
  return 'Invalid payload'
}

console.log(decoded.token)

node ace repl

> (js) config = await import('./config/app.js')

# [Module: null prototype] {
#   appKey: [redacted],
#   http: {
#   }
# }

> (js) console.log(config.appKey)

# [redacted]

import { Secret } from '@adonisjs/core/helpers'
const value = new Secret('some-secret-value')

console.log(value) // [redacted]
console.log(value.release()) // some-secret-value

import { isObject, isArray, isString, isNumber, isBoolean, isFunction, isInteger, isFloat, isDecimal, isDate, isSymbol, isRegExp, isError, isPromise, isMap, isSet, isWeakMap, isWeakSet, isNull, isUndefined, isMissing, isPresent } from '@adonisjs/core/helpers'

import { cuid } from '@adonisjs/core/helpers'

cuid()
// tz4a98xxat96iws9zmbrgj3a

import { compose } from '@adonisjs/core/helpers'

class User extends compose(
  BaseModel,
  UserWithEmail,
  UserWithPassword,
  UserWithAge,
  UserWithAttributes
) {}

import { safeEqual } from '@adonisjs/core/helpers'

const trustedValue = 'hello world'
const userInput = 'hello'

if (safeEqual(trustedValue, userInput)) {
  // 两者相同
} else {
  // 值不匹配
}