@ack_inc/rand-str 中文文档教程

发布于 4年前 浏览 14 项目主页 更新于 3年前

node-rand-str

生成指定长度的随机字符串(小写/大写字母、数字、符号), 并满足指定的约束条件

如果未指定约束条件,则库假定允许使用所有字符

主要用例:密码或临时令牌生成

Deprecation Notice

自 2021 年 5 月 9 日起,此功能已被纳入.npmjs.com/package/@ack_inc/utils">ack_inc/node-utils repo

这个包将不再更新

Usage

const rsg = require('@ack_inc/rand-str');
console.log(rsg(<anything but a whole number>)); //=> throws TypeError
console.log(rsg(0)); //=> ""
console.log(rsg(5)); //=> "3`8aE"
console.log(rsg(5, { lowercase: true })); //=> "fewjk"
console.log(rsg(5, { lowercase: true, uppercase: true, digits: true, symbols: true })); //=> "%q31G"

API

rsg(nChars, constraints)

生成一个长度为 nChars 的字符串,满足 constraints< /代码>

Parameters

nChars

必需。 必须是整数。

constraints

指定生成的字符串中可以包含哪些字符的对象。 它可以具有以下键:

KeyTypeEffect
lowercaseBooleanif true, include lowercase characters
uppercaseBooleanif true, include uppercase chracters
digitsBooleanif true, include digits
symbolsBooleanif true, include symbols

如果 constraints 未提供或为空,则假定允许所有字符

To Do

  • Constraint: whitelisted chars
  • Constraint: blacklisted chars
  • Constraint: symbols that can be part of a url-component (See https://stackoverflow.com/questions/695438/what-are-the-safe-characters-for-making-urls)

node-rand-str

Generate a random string (lower/upper alphabets, digits, symbols) of specified length, and satisfying the specified constraints

If no constraints are specified, the library assumes all characters are allowed

Main use case: password or temporary token generation

Deprecation Notice

As of 9 May 2021, this function has been subsumed into the ack_inc/node-utils repo

This package will no longer be updated

Usage

const rsg = require('@ack_inc/rand-str');
console.log(rsg(<anything but a whole number>)); //=> throws TypeError
console.log(rsg(0)); //=> ""
console.log(rsg(5)); //=> "3`8aE"
console.log(rsg(5, { lowercase: true })); //=> "fewjk"
console.log(rsg(5, { lowercase: true, uppercase: true, digits: true, symbols: true })); //=> "%q31G"

API

rsg(nChars, constraints)

Generate a string of length nChars that satisfies constraints

Parameters

nChars

Required. Must be a whole number.

constraints

Object specifying what characters can be in the generated string. It can have the following keys:

KeyTypeEffect
lowercaseBooleanif true, include lowercase characters
uppercaseBooleanif true, include uppercase chracters
digitsBooleanif true, include digits
symbolsBooleanif true, include symbols

If constraints is not provided or is empty, it is assumed that all characters are allowed

To Do

  • Constraint: whitelisted chars
  • Constraint: blacklisted chars
  • Constraint: symbols that can be part of a url-component (See https://stackoverflow.com/questions/695438/what-are-the-safe-characters-for-making-urls)
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文