Skip to content

ZTL-UwU/cn-lorem-ipsum

Repository files navigation

cn-lorem-ipsum

npm version npm downloads bundle JSDocs License

高效的中文随机 假文&人名 生成库

Playground

Installation

// npm
npm i -D cn-lorem-ipsum

// pnpm
pnpm i -D cn-lorem-ipsum

// bun
bun i -D cn-lorem-ipsum

Usage

import cnLorem from 'cn-lorem-ipsum';

传参类型

interface IOption {
  len?: number; // 固定长度(包含标点与换行)
  min?: number; // 随机长度下限
  max?: number; // 随机长度上限
}

.phrase(opt?: IOption)

生成随机语句(无标点)
默认长度:3~10

cnLorem.phrase();
// 何女由些

cnLorem.phrase({ len: 20 });
// 它分里如美全选格术书分点信着像长有到最那

cnLorem.phrase({ min: 5, max: 8 });
// 整电叫在能许多己

.sentence(opt?: IOption)

生成随机句子
默认长度:15~30

cnLorem.sentence();
// 它高走意年都,种形吃常看亲而,随美在老没。

.paragraph(opt?: IOption)

生成随机段落
默认长度:100~200

cnLorem.paragraph();
/*
始和与您行愿演个未。己落全之个化越找照美你自爱,然方成几些老如报自人前造然。已然关分上南身问当,使答个什情和正它它应并,又而写同后是类,断死无多物我名现,们孩和世心可而从直苦主,女看身进,别工总衣统痛因开能,方年过手直在百双部象报比女。
*/

.article(opt?: IOption)

生成随机文章(含换行)
默认长度:600~1000

cnLorem.article();
/*
名平独想米身必当妈是着两,月亲也夜客司,留笑学意认所,听本回可由达小出争还中。吧我起已得多他爱分,所无生信史把地现它。打文令气以里着成,事果窢回道方名红建夫进这最,上讲西球行说留;很有法其美自爱带大想些也下还作,见约常给动电华,民总住会很问次给无。想和望以些亲张了关晚系全平住演,能事绝东无纪本候站即您在。领意并爱定人总然到次,自且色爱发计名情要。也动手像直么从那和把!子了走文乐如很如中,重道夫准活新这了者等们实便现到。又经高月:布音应们无西。欢情员斯意所最作最,米主从但西亲就此步;世又中日作他在其面你:自望出知。已选得上命同你写元,总满师间它好回意只他很后諣或种。大到面间方使,还手打妈时面保!大然又以己得现里美国着对科,们现记自造解会第出,军马长作月说,家得稜作亚但直又在为人,十半因期十了学着道之。被起光说,已就约手表经望间但的下开。马他者个女学强同而死少三起这,之把间行儿和已,和使那得边回,走你用无统种,合道世通到教此界得或苦会因连,只消的同然,如钱太情大了装最,大子种家东许前然进他。友得于过世总还儿法它首说把作情。国法方动类儿她年活人,路动发斯身,别个加乐年现通天热!次得她眼事记信知交,日夜与钱去与说了方要亲答子量,方种乐眼已因把。许是日条处,各然平上之科军火经面对,车书经许难但提,为她书最都样之爱用个意什亚高意,动晚作随世最向岁意到关几。出记读动由道你完世使。去爸家性心感常制年就,它司会因拿自作斯争而目来字。光间不都快其思道周。感面但次思热动也定,大西如此分如办他。
海第北影只星者有了这树他斯由是,吗身命光与此。来吗那所此出怎就全交每联;断员之爱长欢小,讲又是位没和半联经文最为独点步。爱和立也者活自市,像统最高里间又但回时里,空特的们种国当处知看被海晚者。望年球尼客。在都难同妇此车些落照进喜听长活,花求世女对行复老!金军使者你中点,又所相的保还现,比成表现金进家,没个与年住世美夫下。电英表地书心个之她由不,长没西您常个我但和年只爱装意无,我金山欢好后大;有在爱对期几了实难病儿立,之使者还千窢奇。活来坐做第独城道窢这乎看,给然兴手斯生与之最曾知,拿回吃感会天没感什时千所经但。道工员己可阿意女,紧而世给几死同有常子多心小!比世法奇再说道爸手加身数片却其,画给下亲己布当信,死道头动但动他亲也消感,期刻它如妻情伤同言自到明,为面期放往是但。
*/

.name(opt?: { len?: number })

生成随机人名
默认长度:2~3

cnLorem.name();
// 李秋识

cnLorem.name({ len: 2 });
// 韩迹

Benchmark

paragraph - 1e7
cn-lorem-ipsum 812.0 ms
boocaii/cnlorem 4.964 s

11th Gen Intel i5-1135G7 (8) @ 4.200GHz with bun@1.1.6+e58d67b46

Benchmark 1: bun run cn-lorem-ipsum.ts
  Time (mean ± σ):     812.0 ms ±  14.4 ms    [User: 609.1 ms, System: 237.0 ms]
  Range (min … max):   798.6 ms … 827.2 ms    3 runs
 
Benchmark 2: bun run cnlorem.ts
  Time (mean ± σ):      4.964 s ±  0.280 s    [User: 8.725 s, System: 0.441 s]
  Range (min … max):    4.660 s …  5.212 s    3 runs
 
Summary
  bun run cn-lorem-ipsum.ts ran
    6.11 ± 0.36 times faster than bun run cnlorem.ts

Credits

License

MIT