@yaohaixiao/renames.js 0.0.1

package/tests/pad-start.spec.js

@@ -0,0 +1,27 @@
+import padStart from '@/lib/utils/pad-start.js';
+
+describe('padStart() 方法：', () => {
+  it(`padStart(1)，返回：' 1'`, () => {
+    expect(padStart(1)).toEqual(' 1');
+  });
+
+  it(`padStart('1', '0')，返回：'01'`, () => {
+    expect(padStart('1', '0')).toEqual('01');
+  });
+
+  it(`padStart(1, '0')，返回：'01'`, () => {
+    expect(padStart(1, '0')).toEqual('01');
+  });
+
+  it(`padStart(1, 3, '0')，返回：'001'`, () => {
+    expect(padStart(1, 3, '0')).toEqual('001');
+  });
+
+  it(`padStart(1, 3, '')，返回：'1'`, () => {
+    expect(padStart(1, 3, '')).toEqual('1');
+  });
+
+  it(`padStart(128, 2, '0')，返回：'128'`, () => {
+    expect(padStart(128, 2, '0')).toEqual('128');
+  });
+});

package/tests/pad-zero.spec.js

@@ -0,0 +1,15 @@
+import padZero from '@/lib/utils/pad-zero.js';
+
+describe('padZero() 方法：', () => {
+  it(`padZero(1)，返回：'01'`, () => {
+    expect(padZero(1)).toEqual('01');
+  });
+
+  it(`padZero("1")，返回：'01'`, () => {
+    expect(padZero('1')).toEqual('01');
+  });
+
+  it(`padZero(1, 0)，返回：'1'`, () => {
+    expect(padZero(1, 0)).toEqual('1');
+  });
+});

package/tests/read-dir.spec.js

@@ -0,0 +1,42 @@
+import path from 'node:path';
+
+import readDir from '@/lib/utils/read-dir.js';
+
+const { resolve } = path;
+
+const TESTS_DIR = './tests';
+const ABSOLUTE_PATH = resolve(process.cwd(), TESTS_DIR);
+const FILE_PATH = resolve(process.cwd(), `${TESTS_DIR}/sort-files.spec.js`);
+
+const NOT_EXISTS_PATH = resolve(process.cwd(), './demo/case');
+
+describe(`readDir() 方法：`, () => {
+  it(`readDir('${ABSOLUTE_PATH}', 'utf8', (files) => {console.log(files.length)})，返回：true`, () => {
+    const result = readDir(ABSOLUTE_PATH, 'utf8', (files) => {
+      console.log(files.length);
+    });
+    expect(result.length > 0).toBe(true);
+  });
+
+  it(`readDir('${ABSOLUTE_PATH}', { encoding: 'md' })，返回：true`, () => {
+    const result = readDir(ABSOLUTE_PATH, { encoding: 'md' });
+    expect(result.length > 0).toBe(true);
+  });
+
+  it(`readDir('${ABSOLUTE_PATH}', (files) => {console.log(files.length)})，返回：true`, () => {
+    const result = readDir(ABSOLUTE_PATH, (files) => {
+      console.log(files.length);
+    });
+    expect(result.length > 0).toBe(true);
+  });
+
+  it(`readDir('${FILE_PATH}')，读取文件，获取的文件列表长度，返回：0`, () => {
+    const result = readDir(FILE_PATH);
+    expect(result.length).toEqual(0);
+  });
+
+  it(`readDir('${NOT_EXISTS_PATH}')，读取不存在的文件加路径，获取的文件列表长度，返回：0`, () => {
+    const result = readDir(NOT_EXISTS_PATH);
+    expect(result.length).toEqual(0);
+  });
+});

package/tests/read-file.spec.js

@@ -0,0 +1,52 @@
+import path from 'node:path';
+
+import writeFile from '@/lib/utils/write-file.js';
+import readFile from '@/lib/utils/read-file.js';
+import removeFile from '@/lib/utils/remove-file.js';
+
+const { resolve, dirname } = path;
+
+const FILE_NAME = 'default.config.json';
+const TEMPLATE_DIR = './tests/read';
+const ABSOLUTE_PATH = resolve(process.cwd(), `${TEMPLATE_DIR}/${FILE_NAME}`);
+const CONTENT_FOLDER = '{"folderPath": "./tests"}';
+const OPTIONS = { encoding: 'utf8' };
+
+const afterRead = () => {
+  console.log('已经读取数据完成！');
+};
+
+describe(`readFile() 方法：`, () => {
+  beforeEach(() => {
+    writeFile(ABSOLUTE_PATH, CONTENT_FOLDER, () => {
+      console.log('已写入完成！');
+    });
+  });
+
+  afterEach(() => {
+    // 删除临时文件，确保单测代码干净
+    removeFile(dirname(ABSOLUTE_PATH));
+  });
+
+  it(`readFile('${ABSOLUTE_PATH}','utf8')，返回："${CONTENT_FOLDER}"`, () => {
+    const config = readFile(ABSOLUTE_PATH, 'utf8');
+    expect(config).toEqual(CONTENT_FOLDER);
+  });
+
+  it(`readFile('${ABSOLUTE_PATH}','${OPTIONS}')，返回："${CONTENT_FOLDER}"`, () => {
+    const config = readFile(ABSOLUTE_PATH, OPTIONS, () => {
+      console.log('读取完成！');
+    });
+    expect(config).toEqual(CONTENT_FOLDER);
+  });
+
+  it(`readFile('${ABSOLUTE_PATH}',${afterRead})，返回："${CONTENT_FOLDER}"`, () => {
+    const config = readFile(ABSOLUTE_PATH, afterRead);
+    expect(config).toEqual(CONTENT_FOLDER);
+  });
+
+  it(`readFile('../help.json','utf8')，返回：""`, () => {
+    const config = readFile('../help.json', 'utf8');
+    expect(config).toEqual('');
+  });
+});

package/tests/read-list.spec.js

@@ -0,0 +1,91 @@
+import path from 'node:path';
+import writeFile from '@/lib/utils/write-file.js';
+import removeFile from '@/lib/utils/remove-file.js';
+
+import readList from '@/lib/read-list.js';
+
+const { resolve, dirname } = path;
+
+const TXT_PATH = resolve('./tests/txt/names.txt');
+const NOT_EXISTS_PATH = resolve('./not_exists.txt');
+const NAMES = '封面-1\n' + '封面-3\n' + '封面-2\n' + '封面-4';
+
+const JSON_PATH = resolve('./tests/json/books.json');
+const CHAPTERS = [
+  '神秘的龙珠出现！悟空变成了小孩',
+  null,
+  '我才是主角！小芳踏上宇宙飞行的旅程',
+  '超级抢钱！商人的行星伊美加',
+  '悟空成了通缉犯',
+  '',
+  '快看那个强者！保镖莱德奇',
+  '好痛啊！当牙医的悟空',
+];
+
+const DRAGON_BOLL = {
+  name: '龙珠',
+  chapters: CHAPTERS,
+};
+
+const JS_PATH = resolve('./tests/strip-non-digit.spec.js');
+
+describe('readList() 方法：', () => {
+  beforeEach(() => {
+    writeFile(TXT_PATH, NAMES);
+  });
+
+  afterEach(() => {
+    // 删除临时文件，确保单测代码干净
+    removeFile(dirname(TXT_PATH), () => {
+      console.log(`${TXT_PATH}已删除！`);
+    });
+    removeFile(dirname(JSON_PATH), {
+      maxRetries: 1,
+    });
+  });
+
+  it(`readList('${TXT_PATH}')，检测读取.txt格式文件${TXT_PATH}数据，第1条内容，返回：'封面-1'`, () => {
+    const names = readList(TXT_PATH);
+    expect(names[0]).toEqual('封面-1');
+  });
+
+  it(`readList('${JSON_PATH}')，检测读取.json格式文件${JSON_PATH}数据，第3条内容，返回：'悟空成了通缉犯'`, () => {
+    writeFile(JSON_PATH, JSON.stringify(CHAPTERS));
+    const names = readList(JSON_PATH);
+
+    expect(names.length).toEqual(6);
+    expect(names[3]).toEqual('悟空成了通缉犯');
+  });
+
+  it(`readList('${JSON_PATH}', 'chapters')，检测读取.json格式文件${JSON_PATH}数据中的 'chapters' 属性的数据，第3条内容，返回：'悟空成了通缉犯'`, () => {
+    writeFile(JSON_PATH, JSON.stringify(DRAGON_BOLL));
+    const names = readList(JSON_PATH, 'chapters');
+
+    expect(names.length).toEqual(6);
+    expect(names[3]).toEqual('悟空成了通缉犯');
+  });
+
+  it(`readList('${NOT_EXISTS_PATH}')，检测读取.txt格式文件${NOT_EXISTS_PATH}数据，因为文件不存在，返回：[]`, () => {
+    const names = readList(NOT_EXISTS_PATH);
+    expect(names.length).toEqual(0);
+  });
+
+  it(`readList('${JS_PATH}')，检测读取.js格式文件${NOT_EXISTS_PATH}数据，因为不支持该格式，返回：[]`, () => {
+    const names = readList(JS_PATH);
+    expect(names.length).toEqual(0);
+  });
+
+  it(`readList('${JSON_PATH}')，检测读取.json格式文件${JSON_PATH}数据，因为数据不是JSON数组格式，返回：[]`, () => {
+    writeFile(JSON_PATH, JSON.stringify(DRAGON_BOLL));
+    const names = readList(JSON_PATH);
+
+    expect(names.length).toEqual(0);
+  });
+
+  it(`readList('${JSON_PATH}', 'name')，检测读取.json格式文件${JSON_PATH}数据中的 'name' 属性的数据，因为数据不是数组格式，返回：[]`, () => {
+    writeFile(JSON_PATH, JSON.stringify(DRAGON_BOLL));
+    const names = readList(JSON_PATH, 'name');
+
+    expect(names.length).toEqual(0);
+  });
+});

package/tests/rename.spec.js

@@ -0,0 +1,50 @@
+import path from 'node:path';
+
+import writeFile from '@/lib/utils/write-file.js';
+import removeFile from '@/lib/utils/remove-file.js';
+import isFileExists from '@/lib/utils/is-file-exists.js';
+import rename from '@/lib/utils/rename.js';
+
+const { resolve } = path;
+
+const TEMPLATE_DIR = './tests/rename';
+const OLD_PATH = resolve(`${TEMPLATE_DIR}/readme.txt`);
+const NEW_PATH = resolve(`${TEMPLATE_DIR}/new-readme.txt`);
+const MD_PATH = resolve(`${TEMPLATE_DIR}/readme.md`);
+const NOT_EXISTS_PATH = resolve('./music.mp3');
+
+describe('rename() 方法：', () => {
+  beforeEach(() => {
+    writeFile(OLD_PATH, '# readme 标题');
+  });
+
+  afterEach(() => {
+    // 删除临时文件，确保单测代码干净
+    removeFile(resolve(TEMPLATE_DIR));
+  });
+
+  it(`rename('${OLD_PATH}', '${NEW_PATH}')，检测文件${NEW_PATH}是否存在，返回：true`, () => {
+    rename(OLD_PATH, NEW_PATH);
+    expect(isFileExists(NEW_PATH)).toBe(true);
+  });
+
+  it(`rename('${OLD_PATH}', '${MD_PATH}')，检测文件${MD_PATH}是否存在，返回：true`, () => {
+    rename(OLD_PATH, MD_PATH);
+    expect(isFileExists(MD_PATH)).toBe(true);
+  });
+
+  it(`rename('${OLD_PATH}', '${MD_PATH}', () => {console.log('重命名完成')})，检测文件${MD_PATH}是否存在，返回：true`, () => {
+    rename(OLD_PATH, MD_PATH, () => {
+      console.log('重命名完成');
+    });
+    expect(isFileExists(MD_PATH)).toBe(true);
+  });
+
+  it(`rename('${NOT_EXISTS_PATH}', '${NEW_PATH}')，检测文件${NEW_PATH}是否存在，返回：false`, () => {
+    expect(rename(NOT_EXISTS_PATH, NEW_PATH)).toBe(false);
+  });
+
+  it(`rename('${OLD_PATH}', '${OLD_PATH}')，检测文件名不变${NEW_PATH}，返回：false`, () => {
+    expect(rename(OLD_PATH, OLD_PATH)).toBe(false);
+  });
+});

package/tests/replace-index-chapter.spec.js

@@ -0,0 +1,40 @@
+import replaceIndexChapter from '@/lib/utils/replace-index-chapter.js';
+
+const FILE_NAME = 'S1E1-火影忍者.mp4';
+const chapter = (filename) => {
+  const name = filename.replace(/-(.*)/g, '');
+  const index = name.replace(/(.*)E/g, '');
+  const number = Number(index);
+
+  return {
+    name: `${name}-`,
+    index,
+    number,
+  };
+};
+
+describe('replaceIndexChapter() 方法：', () => {
+  it(`replaceIndexChapter('${FILE_NAME}'), 返回：'S1E1-火影忍者'`, () => {
+    expect(replaceIndexChapter(FILE_NAME)).toBe('S1E1-火影忍者');
+  });
+
+  it(`replaceIndexChapter('${FILE_NAME}', {name: 'S1E1-', index: 1, number: 1}), 返回：'第01集：火影忍者'`, () => {
+    expect(
+      replaceIndexChapter(FILE_NAME, { name: 'S1E1-', index: '1', number: 1 }),
+    ).toBe('第01集：火影忍者');
+  });
+
+  it(`replaceIndexChapter('${FILE_NAME}', {name: 'S1E1-', index: 1, number: 1}, false), 返回：'${FILE_NAME}'`, () => {
+    expect(
+      replaceIndexChapter(
+        FILE_NAME,
+        { name: 'S1E1-', index: '1', number: 1 },
+        false,
+      ),
+    ).toBe('第1集：火影忍者');
+  });
+
+  it(`replaceIndexChapter('${FILE_NAME}', ${chapter}), 返回：'第01集：火影忍者'`, () => {
+    expect(replaceIndexChapter(FILE_NAME, chapter)).toBe('第01集：火影忍者');
+  });
+});

package/tests/sort-files.spec.js

@@ -0,0 +1,221 @@
+import path from 'node:path';
+
+import sortFiles from '@/lib/utils/sort-files.js';
+import readDir from '@/lib/utils/read-dir.js';
+import getBasename from '@/lib/utils/get-basename.js';
+
+const ORIGIN_FILES = [
+  '1.jpg',
+  '8.jpg',
+  '9.jpg',
+  '2.jpg',
+  '5.jpg',
+  '6.jpg',
+  '3.jpg',
+  '4.jpg',
+  '7.jpg',
+  '10.jpg',
+];
+
+const ASC_FILES = [
+  '1.jpg',
+  '2.jpg',
+  '3.jpg',
+  '4.jpg',
+  '5.jpg',
+  '6.jpg',
+  '7.jpg',
+  '8.jpg',
+  '9.jpg',
+  '10.jpg',
+];
+
+const DESC_FILES = [
+  '10.jpg',
+  '9.jpg',
+  '8.jpg',
+  '7.jpg',
+  '6.jpg',
+  '5.jpg',
+  '4.jpg',
+  '3.jpg',
+  '2.jpg',
+  '1.jpg',
+];
+
+const ORIGIN_BOOKS = [
+  'JavaScript Data Structures and Algorithms.pdf',
+  'Express in Action.epub',
+  '凡人修仙传.txt',
+  '仙逆.md',
+  '菊与刀.docx',
+];
+
+const SORT_BY_BOOKS = [
+  'Express in Action.epub',
+  'JavaScript Data Structures and Algorithms.pdf',
+  '仙逆.md',
+  '凡人修仙传.txt',
+  '菊与刀.docx',
+];
+
+const ASC_BOOKS = [
+  '凡人修仙传.txt',
+  '菊与刀.docx',
+  '仙逆.md',
+  'Express in Action.epub',
+  'JavaScript Data Structures and Algorithms.pdf',
+];
+
+const DESC_BOOKS = [
+  'JavaScript Data Structures and Algorithms.pdf',
+  'Express in Action.epub',
+  '仙逆.md',
+  '菊与刀.docx',
+  '凡人修仙传.txt',
+];
+
+const { resolve } = path;
+const { stringify } = JSON;
+const sortBy = (files) => files.toSorted();
+const TESTS_DIR_PATH = resolve(process.cwd(), './lib/utils');
+const JS_FILES = readDir(TESTS_DIR_PATH);
+
+describe('sortFiles() 方法：', () => {
+  const customizeSortByOptions = {
+    sortBy,
+  };
+
+  it(`sortFiles('${ORIGIN_BOOKS}', null), 返回：'${ASC_BOOKS}'`, () => {
+    const sorted = sortFiles(ORIGIN_BOOKS, null);
+    expect(sorted).toEqual(ASC_BOOKS);
+  });
+
+  it(`sortFiles('${ORIGIN_BOOKS}'), 返回：'${ASC_BOOKS}'`, () => {
+    const sorted = sortFiles(ORIGIN_BOOKS);
+    expect(sorted).toEqual(ASC_BOOKS);
+  });
+
+  it(`sortFiles('${ORIGIN_BOOKS}', ${stringify(customizeSortByOptions)}), 自定义排序，返回：'${SORT_BY_BOOKS}'`, () => {
+    const sorted = sortFiles(ORIGIN_BOOKS, customizeSortByOptions);
+    expect(sorted).toEqual(SORT_BY_BOOKS);
+  });
+
+  const sortByNameDescOptions = {
+    sortBy: 'name',
+    order: 'desc',
+  };
+
+  it(`sortFiles('${ORIGIN_FILES}', ${stringify(sortByNameDescOptions)}), 按文件名（desc排序），返回：'${stringify(DESC_FILES)}'`, () => {
+    const sorted = sortFiles(ORIGIN_FILES, sortByNameDescOptions);
+    expect(sorted).toEqual(DESC_FILES);
+  });
+
+  it(`sortFiles('${ORIGIN_BOOKS}', ${stringify(sortByNameDescOptions)}), 按文件名（desc排序），返回：'${stringify(DESC_BOOKS)}'`, () => {
+    const sorted = sortFiles(ORIGIN_BOOKS, sortByNameDescOptions);
+    expect(sorted).toEqual(DESC_BOOKS);
+  });
+
+  const sortByNameAscOptions = {
+    order: 'asc',
+  };
+
+  it(`sortFiles('${ORIGIN_FILES}', ${stringify(sortByNameAscOptions)}), 按文件名（asc排序），返回：'${stringify(ASC_FILES)}'`, () => {
+    const sorted = sortFiles(ORIGIN_FILES, sortByNameAscOptions);
+    expect(sorted).toEqual(ASC_FILES);
+  });
+
+  const sortBySizeDescOptions = {
+    sortBy: 'size',
+    order: 'desc',
+    dirPath: TESTS_DIR_PATH,
+  };
+
+  it(`sortFiles('${JS_FILES}', '${stringify(sortBySizeDescOptions)}'), 按文件大小（desc排序）， 排序后的第1个文件名称，返回：'sort-files'`, () => {
+    const sorted = sortFiles(JS_FILES, sortBySizeDescOptions);
+
+    expect(getBasename(sorted[0])).toEqual('sort-files');
+  });
+
+  const sortBySizeAscOptions = {
+    sortBy: 'size',
+    order: 'asc',
+    dirPath: TESTS_DIR_PATH,
+  };
+
+  it(`sortFiles('${JS_FILES}', '${stringify(sortBySizeAscOptions)}'), 按文件大小（asc排序）， 排序后的第1个文件名称，返回：'strip-non-digit'`, () => {
+    const sorted = sortFiles(JS_FILES, sortBySizeAscOptions);
+
+    expect(getBasename(sorted[0])).toEqual('strip-non-digit');
+  });
+
+  const sortByTypeDescOptions = {
+    sortBy: 'type',
+    order: 'desc',
+  };
+
+  it(`sortFiles('${ORIGIN_BOOKS}', ${stringify(sortByTypeDescOptions)}), 按文件类型（desc排序）， 排序后的第1个文件名称，返回：'凡人修仙传.txt'`, () => {
+    const sorted = sortFiles(ORIGIN_BOOKS, sortByTypeDescOptions);
+
+    expect(sorted[0]).toEqual('凡人修仙传.txt');
+  });
+
+  const sortByTypeAscOptions = {
+    sortBy: 'type',
+    order: 'asc',
+  };
+
+  it(`sortFiles('${ORIGIN_BOOKS}', ${stringify(sortByTypeAscOptions)}), 按文件类型（desc排序）， 排序后的第1个文件名称，返回：'菊与刀.docx'`, () => {
+    const sorted = sortFiles(ORIGIN_BOOKS, sortByTypeAscOptions);
+
+    expect(sorted[0]).toEqual('菊与刀.docx');
+  });
+
+  const sortByModifyTimeAscOptions = {
+    sortBy: 'modify-time',
+    order: 'asc',
+    dirPath: TESTS_DIR_PATH,
+  };
+
+  it(`sortFiles('${JS_FILES}', '${stringify(sortByModifyTimeAscOptions)}'), 按文件修改时间（asc排序）， 排序后的第1个文件名称，返回：'get-basename'`, () => {
+    const sorted = sortFiles(JS_FILES, sortByModifyTimeAscOptions);
+
+    expect(getBasename(sorted[0])).toEqual('get-basename');
+  });
+
+  const sortByModifyTimeDescOptions = {
+    sortBy: 'modify-time',
+    order: 'desc',
+    dirPath: TESTS_DIR_PATH,
+  };
+
+  it(`sortFiles('${JS_FILES}', '${stringify(sortByModifyTimeDescOptions)}'), 按文件修改时间（asc排序）， 排序后的第1个文件名称，返回：'terminal-link'`, () => {
+    const sorted = sortFiles(JS_FILES, sortByModifyTimeDescOptions);
+
+    expect(getBasename(sorted[0])).toEqual('terminal-link');
+  });
+
+  const sortByBirthtimeAscOptions = {
+    sortBy: 'birthtime',
+    order: 'asc',
+    dirPath: TESTS_DIR_PATH,
+  };
+
+  it(`sortFiles('${JS_FILES}', '${stringify(sortByBirthtimeAscOptions)}'), 按文件修改时间（asc排序）， 排序后的第1个文件名称，返回：'get-basename'`, () => {
+    const sorted = sortFiles(JS_FILES, sortByBirthtimeAscOptions);
+
+    expect(getBasename(sorted[0])).toEqual('get-basename');
+  });
+
+  const sortByBirthtimeDescOptions = {
+    sortBy: 'birthtime',
+    order: 'desc',
+    dirPath: TESTS_DIR_PATH,
+  };
+
+  it(`sortFiles('${JS_FILES}', '${stringify(sortByBirthtimeDescOptions)}'), 按文件修改时间（asc排序）， 排序后的第1个文件名称，返回：'terminal-link'`, () => {
+    const sorted = sortFiles(JS_FILES, sortByBirthtimeDescOptions);
+
+    expect(getBasename(sorted[0])).toEqual('terminal-link');
+  });
+});

package/tests/strip-non-digit.spec.js

@@ -0,0 +1,15 @@
+import stripNonDigit from '@/lib/utils/strip-non-digit.js';
+
+describe('stripNonDigit() 方法：', () => {
+  it(`stripNonDigit(1)，返回：''`, () => {
+    expect(stripNonDigit(1)).toEqual('');
+  });
+
+  it(`stripNonDigit('第1集：')，返回：'1'`, () => {
+    expect(stripNonDigit('第1集：')).toEqual('1');
+  });
+
+  it(`stripNonDigit('第1集：我的第1天')，返回：'11'`, () => {
+    expect(stripNonDigit('第1集：我的第1天')).toEqual('11');
+  });
+});

package/tests/to-index-chapter.spec.js

@@ -0,0 +1,31 @@
+import toIndexChapter from '@/lib/utils/to-index-chapter.js';
+
+describe('toIndexChapter() 方法：', () => {
+  it(`toIndexChapter(1), 返回：'第1集：'`, () => {
+    expect(toIndexChapter(1)).toBe('第1集：');
+  });
+
+  it(`toIndexChapter('21'), 返回：'第21集：'`, () => {
+    expect(toIndexChapter('21')).toBe('第21集：');
+  });
+
+  it(`toIndexChapter(1, true), 返回：'1'`, () => {
+    expect(toIndexChapter(1, true)).toBe('1');
+  });
+
+  it(`toIndexChapter('21', true), 返回：'21'`, () => {
+    expect(toIndexChapter('21', true)).toBe('21');
+  });
+
+  it(`toIndexChapter('21', false, { prefix:'', suffix:'话' }), 返回：'21话：'`, () => {
+    expect(toIndexChapter('21', false, { prefix: '', suffix: '话' })).toBe(
+      '21话：',
+    );
+  });
+
+  it(`toIndexChapter('21', false, { suffix:'章', delimiter: '-' }), 返回：'第21章-'`, () => {
+    expect(toIndexChapter('21', false, { suffix: '章', delimiter: '-' })).toBe(
+      '第21章-',
+    );
+  });
+});

package/tests/write-file.spec.js

@@ -0,0 +1,34 @@
+import path from 'node:path';
+
+import writeFile from '@/lib/utils/write-file.js';
+import readFile from '@/lib/utils/read-file.js';
+import removeFile from '@/lib/utils/remove-file.js';
+
+const { resolve, dirname } = path;
+
+const FILE_NAME = 'default.config.json';
+const TEMPLATE_DIR = './tests/write';
+const ABSOLUTE_PATH = resolve(process.cwd(), `${TEMPLATE_DIR}/${FILE_NAME}`);
+const CONTENT_FOLDER = '{"folderPath": "./tests"}';
+const CONTENT_PAD_START = '{"indexPadZero": true}';
+
+describe(`writeFile() 方法：`, () => {
+  afterEach(() => {
+    // 删除临时文件，确保单测代码干净
+    removeFile(dirname(ABSOLUTE_PATH));
+  });
+
+  it(`writeFile('${ABSOLUTE_PATH}','${CONTENT_FOLDER}')，返回："${CONTENT_FOLDER}"`, () => {
+    writeFile(ABSOLUTE_PATH, CONTENT_FOLDER);
+    const config = readFile(ABSOLUTE_PATH, 'utf8');
+    expect(config).toEqual(CONTENT_FOLDER);
+  });
+
+  it(`writeFile('${ABSOLUTE_PATH}','${CONTENT_PAD_START}')，返回："${CONTENT_PAD_START}"`, () => {
+    writeFile(ABSOLUTE_PATH, CONTENT_PAD_START);
+    const config = readFile(ABSOLUTE_PATH, { encoding: 'utf8' }, () => {
+      console.log(`已成功读取"${ABSOLUTE_PATH}"的数据`);
+    });
+    expect(config).toEqual(CONTENT_PAD_START);
+  });
+});