xshell 1.0.6 → 1.0.8

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) ShenHongFei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/file.d.ts

@@ -75,6 +75,16 @@ export declare function fappend(fp: string, data: any, { dir, print }?: {
     dir?: string;
     print?: boolean;
 }): Promise<void>;
+export type FStats = fs.BigIntStats & {
+    fp: string;
+};
+export interface FListOptions {
+    filter?: RegExp | ((fp: string) => any);
+    deep?: boolean;
+    absolute?: boolean;
+    print?: boolean;
+    stats?: boolean;
+}
 /**
     - fpd: 文件夹完整路径 absolute path of directory
     - options?:
@@ -82,16 +92,15 @@ export declare function fappend(fp: string, data: any, { dir, print }?: {
         - absolute?: `false` 返回、打印完整路径而不是相对路径 Return, print full path instead of relative path
         - print?: `true`
         - filter?: `true`  RegExp | (fp: string) => any 注意当 deep = true 时被 filter 过滤掉的目录及目录中的文件不会包含在结果中
-                    Note that when deep = true, directories and files in directories that are filtered out by the filter will not be included in the results */
-export declare function flist(fpd: string, options?: {
-    filter?: RegExp | ((fp: string) => any);
-    deep?: boolean;
-    absolute?: boolean;
-    print?: boolean;
-}): Promise<string[]>;
-export declare function fstat(fp: string): Promise<fs.BigIntStats & {
-    fp: string;
-}>;
+                    Note that when deep = true, directories and files in directories that are filtered out by the filter will not be included in the results
+        - stats?: `false` 启用后返回 FStats 列表, 不能和 deep 一起使用
+                   Returns the FStats list when enabled, cannot be used with deep */
+export declare function flist(fpd: string): Promise<string[]>;
+export declare function flist(fpd: string, options?: FListOptions & {
+    stats: true;
+}): Promise<FStats[]>;
+export declare function flist(fpd: string, options?: FListOptions): Promise<string[]>;
+export declare function fstat(fp: string): Promise<FStats>;
 /** 删除文件或文件夹  delete files or folders
     - fp: 文件或文件夹的完整路径  The full path to the file or folder
     - options?:

package/file.js

@@ -107,16 +107,8 @@ export async function fappend(fp, data, { dir, print = true } = {}) {
         throw new Error(t('data 不是 Buffer 或 string'));
     await fsp.appendFile(fp, data);
 }
-/**
-    - fpd: 文件夹完整路径 absolute path of directory
-    - options?:
-        - deep?: `false` 递归遍历 recursively
-        - absolute?: `false` 返回、打印完整路径而不是相对路径 Return, print full path instead of relative path
-        - print?: `true`
-        - filter?: `true`  RegExp | (fp: string) => any 注意当 deep = true 时被 filter 过滤掉的目录及目录中的文件不会包含在结果中
-                    Note that when deep = true, directories and files in directories that are filtered out by the filter will not be included in the results */
 export async function flist(fpd, options = {}) {
-    const { filter, deep = false, absolute = false, print = true, } = options;
+    const { filter, deep = false, absolute = false, print = true, stats = false } = options;
     if (!path.isAbsolute(fpd))
         throw new Error(t('参数 fpd: ') + fpd + t(' 必须是绝对路径'));
     if (!fpd.endsWith('/'))
@@ -125,10 +117,7 @@ export async function flist(fpd, options = {}) {
     // 都调用了 uv_fs_scandir, 且调用参数相同，仅仅是 Node.js 侧的回调不同 AfterScanDir / AfterScanDirWithTypes
     // 回调中通过 uv_fs_scandir_next 获取到每个条目的信息，而 uv_fs_scandir_next 中都会读取 type
     // 速度上：都在 0.2 ms 左右就可以完成
-    const files = await fsp.readdir(fpd, {
-        withFileTypes: true,
-        encoding: 'utf-8',
-    });
+    const files = await fsp.readdir(fpd, { withFileTypes: true, encoding: 'utf-8' });
     const filter_regexp = filter instanceof RegExp;
     const filter_fn = Boolean(filter && !filter_regexp);
     let fps = [];
@@ -144,15 +133,18 @@ export async function flist(fpd, options = {}) {
             console.log(fp);
         fps.push(fp);
     }
-    return deep ? (await Promise.all(fps.map(async (fp) => fp.endsWith('/') ?
-        [
-            fp,
-            ...(await flist(absolute ? fp : fpd + fp, options)).map(fp_ => absolute ? fp_ : fp + fp_)
-        ]
-        :
-            fp))).flat()
-        :
-            fps;
+    if (deep)
+        return (await Promise.all(fps.map(async (fp) => fp.endsWith('/') ?
+            [
+                fp,
+                ...(await flist(absolute ? fp : fpd + fp, options)).map(fp_ => absolute ? fp_ : fp + fp_)
+            ]
+            :
+                fp))).flat();
+    else if (stats)
+        return Promise.all(fps.map(fp => fstat(absolute ? fp : fpd + fp)));
+    else
+        return fps;
 }
 export async function fstat(fp) {
     if (!path.isAbsolute(fp))

package/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["file.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    promises as fsp,\n    default as fs,\n} from 'fs'\ntype FileHandle = fsp.FileHandle & { fp: string }\n\nimport path from 'upath'\nimport iconv from 'iconv-lite'\nimport fse from 'fs-extra'\n\nimport debounce from 'lodash/debounce.js'\n\n\nimport MFS from 'memfs'\ndeclare module 'memfs' {\n    interface IFs {\n        join: typeof path.join\n        is_mfs: true\n    }\n}\n\n\nimport { t } from './i18n/instance.js'\nimport { to_json } from './prototype.js'\nimport { assert } from './utils.js'\n\n\nexport * from './ufs.js'\n\nexport { MFS }\n\nexport type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'binary'\n\n\n/** fp 所指向的 文件/ 文件夹 是否存在  \n    Does the file/folder pointed to by fp exist?  */\nexport function fexists (fp: string, { print = true }: { print?: boolean } = { }) {\n    const exists = fs.existsSync(fp)\n    \n    if (print)\n        console.log(exists ? t('已存在') : t('不存在'), fp)\n    \n    return exists\n}\n\n\n/** 打开文件，返回 FileHandle  \n    open file, return FileHandle  \n    Some characters (`< > : \" / \\ | ? *`) are reserved under Windows as documented\n    by [Naming Files, Paths, and Namespaces](https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file). Under NTFS, if the filename contains\n    a colon, Node.js will open a file system stream, as described by [this MSDN page](https://docs.microsoft.com/en-us/windows/desktop/FileIO/using-streams).\n    \n    - flags: `'r'`\n    - options?:\n        - mode?: `'0o666'` Sets the file mode (permission and sticky bits) if the file is created. */\nexport async function fopen (\n    fp: string,\n    flags: string | number,\n    { mode, print }: { mode?: fs.Mode, print?: boolean } = { }\n) {\n    if (print)\n        console.log(t('打开文件'), fp)\n    \n    return Object.assign(\n        await fsp.open(fp, flags, mode),\n        { fp, flags, mode }\n    )\n}\n\n\nexport function create_mfs () {\n    let mfs = MFS.createFsFromVolume(\n        new MFS.Volume()\n    )\n    \n    mfs.join = path.join.bind(path)\n    mfs.is_mfs = true\n    \n    return mfs\n}\n\n\nexport async function fread (fp: string): Promise<string>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding: 'binary', print?: boolean }): Promise<Buffer>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding?: Encoding | 'auto', print?: boolean }): Promise<string>\nexport async function fread (fp: string, {\n    dir, \n    encoding = 'utf-8', \n    print = true\n}: {\n    dir?: string\n    encoding?: Encoding | 'auto'\n    print?: boolean } = { }\n) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error(t('fp 必须是绝对路径，或传入 dir 参数: ') + fp)\n    \n    if (print)\n        console.log(t('读取'), fp)\n    \n    switch (encoding) {\n        case 'utf-8':\n            return fsp.readFile(fp, { encoding: 'utf-8' })\n        \n        case 'binary':\n            return fsp.readFile(fp)\n        \n        default: {\n            const buffer = await fsp.readFile(fp)\n            \n            if (encoding === 'auto') {\n                const { detect } = await import('chardet')\n                encoding = detect(buffer) as any\n                if (print)\n                    console.log(fp + t(' 的编码可能是 ') + encoding.toLowerCase())\n            }\n            \n            return iconv.decode(buffer, encoding)\n        }\n    }\n}\n\nexport async function fread_lines (fp: string, options: { dir?: string, encoding?: Exclude<Encoding, 'binary'> | 'auto', print?: boolean } = { }) {\n    return (await fread(fp, options))\n        .split_lines()\n}\n\nexport async function fread_json <T = any> (fp: string, options: { dir?: string, encoding?: Encoding, print?: boolean } = { }): Promise<T> {\n    return JSON.parse(await fread(fp, options))\n}\n\n\nexport async function fwrite (fp: string | FileHandle, data: Buffer, options?: { dir?: string, print?: boolean, mkdir?: boolean }): Promise<void>\nexport async function fwrite (fp: string | FileHandle, data: any, options?: { dir?: string, encoding?: Encoding, print?: boolean, mkdir?: boolean }): Promise<void>\nexport async function fwrite (\n    fp: string | FileHandle,\n    data: any,\n    {\n        dir,\n        encoding = 'utf-8',\n        print = true,\n        mkdir = false,\n    }: {\n        dir?: string\n        encoding?: Encoding\n        print?: boolean\n        mkdir?: boolean\n    } = { }\n) {\n    const is_handle = typeof fp === 'object' && fp && 'fd' in fp\n    if (is_handle) {\n        if (print)\n            console.log(t('写入'), (fp as FileHandle).fp)\n    } else {\n        if (dir)\n            fp = path.join(dir, fp)\n        else if (!path.isAbsolute(fp as string))\n            throw new Error(t('fp 必须是绝对路径，或传入 dir 参数: ') + fp)\n        \n        if (print)\n            console.log(t('写入'), fp)\n    }\n    \n    if (encoding === 'gb18030')\n        data = iconv.encode(data, encoding)\n    \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        data = to_json(data)\n    \n    try {\n        await fsp.writeFile(fp, data)\n    } catch (error) {\n        if (!mkdir || error.code !== 'ENOENT' || is_handle)\n            throw error\n        \n        await fmkdir((fp as string).fdir)\n        await fsp.writeFile(fp, data)\n    }\n}\n\nexport async function fappend (fp: string, data: any, { dir, print = true }: { dir?: string, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error(t('fp 必须是绝对路径，或传入 dir 参数: ') + fp)\n    \n    if (print)\n        console.log(t('追加'), fp)\n        \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        throw new Error(t('data 不是 Buffer 或 string'))\n        \n    await fsp.appendFile(fp, data)\n}\n\n\n/**\n    - fpd: 文件夹完整路径 absolute path of directory\n    - options?:\n        - deep?: `false` 递归遍历 recursively\n        - absolute?: `false` 返回、打印完整路径而不是相对路径 Return, print full path instead of relative path\n        - print?: `true`\n        - filter?: `true`  RegExp | (fp: string) => any 注意当 deep = true 时被 filter 过滤掉的目录及目录中的文件不会包含在结果中  \n                    Note that when deep = true, directories and files in directories that are filtered out by the filter will not be included in the results */\nexport async function flist (\n    fpd: string,\n    options: {\n        filter?: RegExp | ((fp: string) => any)\n        deep?: boolean\n        absolute?: boolean\n        print?: boolean\n    } = { }\n): Promise<string[]> {\n    const {\n        filter,\n        deep = false,\n        absolute = false,\n        print = true,\n    } = options\n    \n    if (!path.isAbsolute(fpd))\n        throw new Error(t('参数 fpd: ') + fpd + t(' 必须是绝对路径'))\n    \n    if (!fpd.endsWith('/'))\n        throw new Error(t('参数 fpd: ') + fpd + t(' 必须以 / 结尾'))\n    \n    // readdir withFileTypes 参数在底层有什么区别，速度上有什么差异\n    // 都调用了 uv_fs_scandir, 且调用参数相同，仅仅是 Node.js 侧的回调不同 AfterScanDir / AfterScanDirWithTypes\n    // 回调中通过 uv_fs_scandir_next 获取到每个条目的信息，而 uv_fs_scandir_next 中都会读取 type\n    // 速度上：都在 0.2 ms 左右就可以完成\n    \n    const files = await fsp.readdir(fpd, {\n        withFileTypes: true,\n        encoding: 'utf-8',\n    })\n    \n    const filter_regexp = filter instanceof RegExp\n    const filter_fn = Boolean(filter && !filter_regexp)\n    \n    let fps: string[] = [ ]\n    \n    for (const file of files) {\n        const fp = \n            (absolute ? fpd : '') +\n            file.name +\n            (file.isDirectory() ? '/' : '')\n        \n        if (filter_regexp && !filter.test(fp))\n            continue\n        \n        if (filter_fn && !(filter as Function)(fp))\n            continue\n        \n        if (print)\n            console.log(fp)\n        \n        fps.push(fp)\n    }\n    \n    return deep ? (\n                await Promise.all(\n                    fps.map(async fp => \n                        fp.endsWith('/') ?\n                            [\n                                fp,\n                                ... (await flist(\n                                    absolute ? fp : fpd + fp,\n                                    options\n                                )).map(fp_ => \n                                    absolute ? fp_ : fp + fp_)\n                            ]\n                        :\n                            fp)\n                )\n            ).flat()\n        :\n            fps\n}\n\n\nexport async function fstat (fp: string): Promise<fs.BigIntStats & { fp: string }> {\n    if (!path.isAbsolute(fp))\n        throw new Error('fp: ' + fp + t(' 必须是绝对路径'))\n    \n    let stat = await fsp.stat(fp, { bigint: true })\n    ;(stat as any).fp = fp\n    \n    return stat as any\n}\n\n\n/** 删除文件或文件夹  delete files or folders  \n    - fp: 文件或文件夹的完整路径  The full path to the file or folder\n    - options?:\n        - print?: `true`\n    \n    返回是否实际进行了删除操作  \n    Returns whether the delete operation actually took place */\nexport async function fdelete (fp: string, { print = true }: { print?: boolean } = { }) {\n    assert(fp.length >= 6, `fp: ${fp} ${t('不能太短，防止误删文件')}`)\n    assert(path.isAbsolute(fp), t('fp 必须是绝对路径'))\n    \n    try {\n        await fsp.rm(fp, { recursive: true })\n        if (print)\n            if (fp.endsWith('/'))\n                console.log((t('删除了文件夹: ') + fp).red)\n            else\n                console.log((t('删除了文件: ') + fp).red)\n        return true\n    } catch (error) {\n        if (error.code === 'ENOENT') {\n            if (print)\n                if (fp.endsWith('/'))\n                    console.log(t('文件夹已不存在: ') + fp)\n                else\n                    console.log(t('文件已不存在: ') + fp)\n            return false\n        }\n        \n        throw error\n    }\n}\n\n\n/** 复制文件或文件夹  copy file or direcotry\n    - fp_src: 源 文件/文件夹 完整路径  src file/directory absolute path\n    - fp_dst: 目标 文件/文件夹 完整路径  dst file/directory absolute path\n    - options?:\n        print?: `true`\n        overwrite?: `true`\n    \n    @example\n    fcopy('d:/temp/camera/', 'd:/camera/') */\nexport async function fcopy (fp_src: string, fp_dst: string, {\n    print = true,\n    overwrite = true,\n}: {\n    print?: boolean\n    overwrite?: boolean\n} = { }) {\n    assert(fp_src.endsWith('/') === fp_dst.endsWith('/'), t('fp_src 和 fp_dst 必须同为文件路径或文件夹路径'))\n    assert(path.isAbsolute(fp_src) && path.isAbsolute(fp_dst), t('fp_src 和 fp_dst 必须为完整路径'))\n    \n    if (print)\n        console.log(t('复制'), fp_src, '→', fp_dst)\n    \n    await fse.copy(fp_src, fp_dst, { overwrite, errorOnExist: true })\n}\n\n\n/** 移动文件或文件夹  move file or direcotry\n    - src: 源 文件/文件夹 完整路径  src file/directory absolute path\n    - dst: 目标 文件/文件夹 完整路径  dst file/directory absolute path\n    @example\n    fmove('d:/temp/camera/', 'd:/camera/') */\nexport async function fmove (src: string, dst: string, {\n    overwrite = false,\n    print = true\n}: {\n    overwrite?: boolean\n    print?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/'))\n        throw new Error(t('src 和 dst 必须同为文件路径或文件夹路径'))\n    \n    if (!path.isAbsolute(src) || !path.isAbsolute(dst))\n        throw new Error(t('src 和 dst 必须为完整路径'))\n    \n    if (print)\n        console.log(t('移动'), src, '→', dst)\n    \n    await fse.move(src, dst, { overwrite })\n}\n\n\n/** 重命名文件  rename file  \n    - fp:  当前文件名／路径  current filename/path\n    - fp_: 新的文件名／路径  new filename/path\n    - options?:\n        - fpd?: fp 和 fp_ 在同一文件夹内  fp and fp_ is in same directory\n        - print?: `true`\n        - overwrite?: `true`  默认覆盖（不检查效率更高）  better performance without check */\nexport async function frename (\n    fp: string, \n    fp_: string,\n    {\n        fpd,\n        print = true,\n        overwrite = true\n    }: {\n        fpd?: string\n        print?: boolean\n        overwrite?: boolean\n    } = { }\n) {\n    if (fpd) {\n        fp = path.join(fpd, fp)\n        fp_ = path.join(fpd, fp_)\n    } else if (!path.isAbsolute(fp) || !path.isAbsolute(fp_))\n        throw new Error(t('fp 和 fp_ 必须是绝对路径'))\n    \n    if (print)\n        console.log(t('重命名'), fp, '→', fp_)\n    \n    if (!overwrite && fexists(fp_))\n        throw new Error(t('文件已存在：') + fp_)\n    \n    await fsp.rename(fp, fp_)\n}\n\n\n/**\n    递归创建文件夹，确保 fpd 指向的文件夹存在  Create folders recursively, make sure the folder pointed to by fpd exists  \n    返回首个创建的文件夹或 undefined  Returns the first created folder or undefined\n    \n    - fpd: 文件夹完整路径  Folder full path\n    - options?:\n        - print?: `true`\n        - mode?: `'0o777'` */\nexport async function fmkdir (\n    fpd: string,\n    {\n        print = true,\n        mode,\n    }: {\n        print?: boolean\n        \n        /** `0o777` A file mode. If a string is passed, it is parsed as an octal integer. */\n        mode?: string | number\n    } = { }\n) {\n    assert(path.isAbsolute(fpd), t('fpd 必须是绝对路径: ') + fpd)\n    assert(fpd.endsWith('/'), t('fpd 必须以 / 结尾: ') + fpd)\n    \n    // CallingfsPromises.mkdir() when path is a directory that exists results in a rejection only when recursive is false.\n    const fpd_ = (\n        await fsp.mkdir(fpd, { recursive: true, mode })\n    )?.replaceAll('\\\\', '/')\n    \n    if (fpd_) {\n        if (print)\n            console.log(t('已创建文件夹'), fpd)\n    } else\n        if (print)\n            console.log(t('已存在文件夹'), fpd)\n    \n    return fpd_\n}\n\n\n/** 创建软链接  Create soft links  \n    - fp_real: 现在真实文件/文件夹的路径  current real file/directory path\n    - fp_link: 目标链接文件/文件夹的路径  target file/directory path */\nexport async function flink (\n    fp_real: string, \n    fp_link: string, \n    {\n        junction = false,\n        print = true \n    }: { \n        junction?: boolean\n        print?: boolean\n} = { }) {\n    assert(path.isAbsolute(fp_real) && path.isAbsolute(fp_link), t('fp 必须是绝对路径'))\n    \n    const is_fpd_real = fp_real.endsWith('/')\n    const is_fpd_link = fp_link.endsWith('/')\n    \n    assert(is_fpd_real === is_fpd_link, t('fp_real 和 fp_link 必须同为文件路径或文件夹路径'))\n    \n    if (fexists(fp_link))\n        throw new Error(t('存在同名') + (is_fpd_link ? t('文件夹') : t('文件')) + ': ' + fp_link + t('，无法创建链接'))\n    \n    if (print)\n        console.log(t('已将源文件 ') + fp_real + t(' 链接到 ') + fp_link)\n    \n    if (junction)\n        fsp.symlink(fp_real, fp_link, 'junction')\n    else\n        fsp.symlink(fp_real, fp_link, is_fpd_real ? 'dir' : 'file')\n}\n\n\nexport let fwatchers: Record<string, fs.FSWatcher> = { }\n\n/**\n    - fp: 文件或文件夹路径  path of file or directory\n    - callback: 文件修改时回调  called when modified\n    - exec: `true` 首次 watch 时执行 onchange  call callback when watch is executed\n    \n    创建的 fs.FSWatcher 保存在 watchers 中, 再次调用相同的 fp 会自动关闭已有的 watcher  \n    save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp\n    \n    https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener  \n    The listener callback gets two arguments (event, fname). \n        event is either 'rename' or 'change', and filename is the name of the file which triggered the event.\n        On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.\n    \n    The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of event. */\nexport async function fwatch (\n    fp: string,\n    onchange: (event: string, fname: string) => any, \n    { exec = true }: { exec?: boolean } = { }\n) {\n    if (!path.isAbsolute(fp))\n        throw new Error(t('fp 必须是完整路径'))\n    \n    const _watcher = fwatchers[fp]\n    if (_watcher)\n        _watcher.close()\n    \n    if (exec)\n        await onchange('change', fp.fname)\n    \n    const start = new Date().getTime()\n    \n    const debounced_onchange = debounce(\n        (event, fname) => {\n            if (new Date().getTime() - start < 800)\n                return\n            console.log(t('文件修改 (') + event + '): ' + fname)\n            onchange(event, path.normalize(fname))\n        },\n        500,\n        { leading: false, trailing: true }\n    )\n    \n    let watcher = fs.watch(fp, debounced_onchange)\n    watcher.on('error', error => {\n        console.error(error)\n    })\n    return fwatchers[fp] = watcher\n}\n\n\n/** 打开一个文件并搜索替换某个 pattern  open a file and replace certain pattern */\nexport async function freplace (fp: string, pattern: string | RegExp, replacement: string) {\n    await fwrite(\n        fp,\n        (await fread(fp))\n            .replaceAll(pattern, replacement)\n    )\n}\n\n/** 将文件编码转为 UTF-8  convert file encoding to UTF-8\n    - fp: 文件完整路径  file absolute path\n    - options?:\n        - dryrun?: `true`\n        - encoding?: `'auto'` */\nexport async function f2utf8 (fp: string, {\n    dryrun = true,\n    encoding = 'auto',\n}: {\n    dryrun?: boolean\n    encoding?: Encoding | 'auto'\n} = { }) {\n    const text = await fread(fp, { encoding })\n    if (dryrun) {\n        console.log(text.slice(0, 10000))\n        return\n    }\n    \n    const fp_bak = `${fp.fdir}${fp.fname.replace(/(.*?)(\\.[^.]+)?$/, '$1.bak$2')}`\n    if (!fexists(fp_bak))\n        await fcopy(fp, fp_bak)\n    \n    await fwrite(fp, text)\n}\n\n"]}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["file.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    promises as fsp,\n    default as fs,\n} from 'fs'\ntype FileHandle = fsp.FileHandle & { fp: string }\n\nimport path from 'upath'\nimport iconv from 'iconv-lite'\nimport fse from 'fs-extra'\n\nimport debounce from 'lodash/debounce.js'\n\n\nimport MFS from 'memfs'\ndeclare module 'memfs' {\n    interface IFs {\n        join: typeof path.join\n        is_mfs: true\n    }\n}\n\n\nimport { t } from './i18n/instance.js'\nimport { to_json } from './prototype.js'\nimport { assert } from './utils.js'\n\n\nexport * from './ufs.js'\n\nexport { MFS }\n\nexport type Encoding = 'utf-8' | 'gb18030' | 'shift-jis' | 'binary'\n\n\n/** fp 所指向的 文件/ 文件夹 是否存在  \n    Does the file/folder pointed to by fp exist?  */\nexport function fexists (fp: string, { print = true }: { print?: boolean } = { }) {\n    const exists = fs.existsSync(fp)\n    \n    if (print)\n        console.log(exists ? t('已存在') : t('不存在'), fp)\n    \n    return exists\n}\n\n\n/** 打开文件，返回 FileHandle  \n    open file, return FileHandle  \n    Some characters (`< > : \" / \\ | ? *`) are reserved under Windows as documented\n    by [Naming Files, Paths, and Namespaces](https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file). Under NTFS, if the filename contains\n    a colon, Node.js will open a file system stream, as described by [this MSDN page](https://docs.microsoft.com/en-us/windows/desktop/FileIO/using-streams).\n    \n    - flags: `'r'`\n    - options?:\n        - mode?: `'0o666'` Sets the file mode (permission and sticky bits) if the file is created. */\nexport async function fopen (\n    fp: string,\n    flags: string | number,\n    { mode, print }: { mode?: fs.Mode, print?: boolean } = { }\n) {\n    if (print)\n        console.log(t('打开文件'), fp)\n    \n    return Object.assign(\n        await fsp.open(fp, flags, mode),\n        { fp, flags, mode }\n    )\n}\n\n\nexport function create_mfs () {\n    let mfs = MFS.createFsFromVolume(\n        new MFS.Volume()\n    )\n    \n    mfs.join = path.join.bind(path)\n    mfs.is_mfs = true\n    \n    return mfs\n}\n\n\nexport async function fread (fp: string): Promise<string>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding: 'binary', print?: boolean }): Promise<Buffer>\nexport async function fread (fp: string, { dir, encoding, print }?: { dir?: string, encoding?: Encoding | 'auto', print?: boolean }): Promise<string>\nexport async function fread (fp: string, {\n    dir, \n    encoding = 'utf-8', \n    print = true\n}: {\n    dir?: string\n    encoding?: Encoding | 'auto'\n    print?: boolean } = { }\n) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error(t('fp 必须是绝对路径，或传入 dir 参数: ') + fp)\n    \n    if (print)\n        console.log(t('读取'), fp)\n    \n    switch (encoding) {\n        case 'utf-8':\n            return fsp.readFile(fp, { encoding: 'utf-8' })\n        \n        case 'binary':\n            return fsp.readFile(fp)\n        \n        default: {\n            const buffer = await fsp.readFile(fp)\n            \n            if (encoding === 'auto') {\n                const { detect } = await import('chardet')\n                encoding = detect(buffer) as any\n                if (print)\n                    console.log(fp + t(' 的编码可能是 ') + encoding.toLowerCase())\n            }\n            \n            return iconv.decode(buffer, encoding)\n        }\n    }\n}\n\nexport async function fread_lines (fp: string, options: { dir?: string, encoding?: Exclude<Encoding, 'binary'> | 'auto', print?: boolean } = { }) {\n    return (await fread(fp, options))\n        .split_lines()\n}\n\nexport async function fread_json <T = any> (fp: string, options: { dir?: string, encoding?: Encoding, print?: boolean } = { }): Promise<T> {\n    return JSON.parse(await fread(fp, options))\n}\n\n\nexport async function fwrite (fp: string | FileHandle, data: Buffer, options?: { dir?: string, print?: boolean, mkdir?: boolean }): Promise<void>\nexport async function fwrite (fp: string | FileHandle, data: any, options?: { dir?: string, encoding?: Encoding, print?: boolean, mkdir?: boolean }): Promise<void>\nexport async function fwrite (\n    fp: string | FileHandle,\n    data: any,\n    {\n        dir,\n        encoding = 'utf-8',\n        print = true,\n        mkdir = false,\n    }: {\n        dir?: string\n        encoding?: Encoding\n        print?: boolean\n        mkdir?: boolean\n    } = { }\n) {\n    const is_handle = typeof fp === 'object' && fp && 'fd' in fp\n    if (is_handle) {\n        if (print)\n            console.log(t('写入'), (fp as FileHandle).fp)\n    } else {\n        if (dir)\n            fp = path.join(dir, fp)\n        else if (!path.isAbsolute(fp as string))\n            throw new Error(t('fp 必须是绝对路径，或传入 dir 参数: ') + fp)\n        \n        if (print)\n            console.log(t('写入'), fp)\n    }\n    \n    if (encoding === 'gb18030')\n        data = iconv.encode(data, encoding)\n    \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        data = to_json(data)\n    \n    try {\n        await fsp.writeFile(fp, data)\n    } catch (error) {\n        if (!mkdir || error.code !== 'ENOENT' || is_handle)\n            throw error\n        \n        await fmkdir((fp as string).fdir)\n        await fsp.writeFile(fp, data)\n    }\n}\n\nexport async function fappend (fp: string, data: any, { dir, print = true }: { dir?: string, print?: boolean } = { }) {\n    if (dir)\n        fp = path.join(dir, fp)\n    else if (!path.isAbsolute(fp))\n        throw new Error(t('fp 必须是绝对路径，或传入 dir 参数: ') + fp)\n    \n    if (print)\n        console.log(t('追加'), fp)\n        \n    if (!Buffer.isBuffer(data) && typeof data !== 'string')\n        throw new Error(t('data 不是 Buffer 或 string'))\n        \n    await fsp.appendFile(fp, data)\n}\n\n\nexport type FStats = fs.BigIntStats & { fp: string }\n\nexport interface FListOptions {\n    filter?: RegExp | ((fp: string) => any)\n    deep?: boolean\n    absolute?: boolean\n    print?: boolean\n    stats?: boolean\n}\n\n/**\n    - fpd: 文件夹完整路径 absolute path of directory\n    - options?:\n        - deep?: `false` 递归遍历 recursively\n        - absolute?: `false` 返回、打印完整路径而不是相对路径 Return, print full path instead of relative path\n        - print?: `true`\n        - filter?: `true`  RegExp | (fp: string) => any 注意当 deep = true 时被 filter 过滤掉的目录及目录中的文件不会包含在结果中  \n                    Note that when deep = true, directories and files in directories that are filtered out by the filter will not be included in the results \n        - stats?: `false` 启用后返回 FStats 列表, 不能和 deep 一起使用  \n                   Returns the FStats list when enabled, cannot be used with deep */\nexport async function flist (fpd: string): Promise<string[]>\nexport async function flist (fpd: string, options?: FListOptions & { stats: true }): Promise<FStats[]>\nexport async function flist (fpd: string, options?: FListOptions): Promise<string[]>\nexport async function flist (fpd: string, options: FListOptions = { }): Promise<string[] | FStats[]> {\n    const {\n        filter,\n        deep = false,\n        absolute = false,\n        print = true,\n        stats = false\n    } = options\n    \n    if (!path.isAbsolute(fpd))\n        throw new Error(t('参数 fpd: ') + fpd + t(' 必须是绝对路径'))\n    \n    if (!fpd.endsWith('/'))\n        throw new Error(t('参数 fpd: ') + fpd + t(' 必须以 / 结尾'))\n    \n    // readdir withFileTypes 参数在底层有什么区别，速度上有什么差异\n    // 都调用了 uv_fs_scandir, 且调用参数相同，仅仅是 Node.js 侧的回调不同 AfterScanDir / AfterScanDirWithTypes\n    // 回调中通过 uv_fs_scandir_next 获取到每个条目的信息，而 uv_fs_scandir_next 中都会读取 type\n    // 速度上：都在 0.2 ms 左右就可以完成\n    \n    const files = await fsp.readdir(fpd, { withFileTypes: true, encoding: 'utf-8' })\n    \n    const filter_regexp = filter instanceof RegExp\n    const filter_fn = Boolean(filter && !filter_regexp)\n    \n    let fps: string[] = [ ]\n    \n    for (const file of files) {\n        const fp = \n            (absolute ? fpd : '') +\n            file.name +\n            (file.isDirectory() ? '/' : '')\n        \n        if (filter_regexp && !filter.test(fp))\n            continue\n        \n        if (filter_fn && !(filter as Function)(fp))\n            continue\n        \n        if (print)\n            console.log(fp)\n        \n        fps.push(fp)\n    }\n    \n    if (deep)\n        return (\n            await Promise.all(\n                fps.map(async fp => \n                    fp.endsWith('/') ?\n                        [\n                            fp,\n                            ... (await flist(\n                                absolute ? fp : fpd + fp,\n                                options\n                            )).map(fp_ => absolute ? fp_ : fp + fp_)\n                        ]\n                    :\n                        fp))\n        ).flat()\n    else\n        if (stats)\n            return Promise.all(\n                fps.map(fp => fstat(absolute ? fp : fpd + fp))\n            )\n        else\n            return fps\n}\n\n\nexport async function fstat (fp: string): Promise<FStats> {\n    if (!path.isAbsolute(fp))\n        throw new Error('fp: ' + fp + t(' 必须是绝对路径'))\n    \n    let stat = await fsp.stat(fp, { bigint: true })\n    ;(stat as any).fp = fp\n    \n    return stat as any\n}\n\n\n/** 删除文件或文件夹  delete files or folders  \n    - fp: 文件或文件夹的完整路径  The full path to the file or folder\n    - options?:\n        - print?: `true`\n    \n    返回是否实际进行了删除操作  \n    Returns whether the delete operation actually took place */\nexport async function fdelete (fp: string, { print = true }: { print?: boolean } = { }) {\n    assert(fp.length >= 6, `fp: ${fp} ${t('不能太短，防止误删文件')}`)\n    assert(path.isAbsolute(fp), t('fp 必须是绝对路径'))\n    \n    try {\n        await fsp.rm(fp, { recursive: true })\n        if (print)\n            if (fp.endsWith('/'))\n                console.log((t('删除了文件夹: ') + fp).red)\n            else\n                console.log((t('删除了文件: ') + fp).red)\n        return true\n    } catch (error) {\n        if (error.code === 'ENOENT') {\n            if (print)\n                if (fp.endsWith('/'))\n                    console.log(t('文件夹已不存在: ') + fp)\n                else\n                    console.log(t('文件已不存在: ') + fp)\n            return false\n        }\n        \n        throw error\n    }\n}\n\n\n/** 复制文件或文件夹  copy file or direcotry\n    - fp_src: 源 文件/文件夹 完整路径  src file/directory absolute path\n    - fp_dst: 目标 文件/文件夹 完整路径  dst file/directory absolute path\n    - options?:\n        print?: `true`\n        overwrite?: `true`\n    \n    @example\n    fcopy('d:/temp/camera/', 'd:/camera/') */\nexport async function fcopy (fp_src: string, fp_dst: string, {\n    print = true,\n    overwrite = true,\n}: {\n    print?: boolean\n    overwrite?: boolean\n} = { }) {\n    assert(fp_src.endsWith('/') === fp_dst.endsWith('/'), t('fp_src 和 fp_dst 必须同为文件路径或文件夹路径'))\n    assert(path.isAbsolute(fp_src) && path.isAbsolute(fp_dst), t('fp_src 和 fp_dst 必须为完整路径'))\n    \n    if (print)\n        console.log(t('复制'), fp_src, '→', fp_dst)\n    \n    await fse.copy(fp_src, fp_dst, { overwrite, errorOnExist: true })\n}\n\n\n/** 移动文件或文件夹  move file or direcotry\n    - src: 源 文件/文件夹 完整路径  src file/directory absolute path\n    - dst: 目标 文件/文件夹 完整路径  dst file/directory absolute path\n    @example\n    fmove('d:/temp/camera/', 'd:/camera/') */\nexport async function fmove (src: string, dst: string, {\n    overwrite = false,\n    print = true\n}: {\n    overwrite?: boolean\n    print?: boolean\n} = { }) {\n    if (src.endsWith('/') !== dst.endsWith('/'))\n        throw new Error(t('src 和 dst 必须同为文件路径或文件夹路径'))\n    \n    if (!path.isAbsolute(src) || !path.isAbsolute(dst))\n        throw new Error(t('src 和 dst 必须为完整路径'))\n    \n    if (print)\n        console.log(t('移动'), src, '→', dst)\n    \n    await fse.move(src, dst, { overwrite })\n}\n\n\n/** 重命名文件  rename file  \n    - fp:  当前文件名／路径  current filename/path\n    - fp_: 新的文件名／路径  new filename/path\n    - options?:\n        - fpd?: fp 和 fp_ 在同一文件夹内  fp and fp_ is in same directory\n        - print?: `true`\n        - overwrite?: `true`  默认覆盖（不检查效率更高）  better performance without check */\nexport async function frename (\n    fp: string, \n    fp_: string,\n    {\n        fpd,\n        print = true,\n        overwrite = true\n    }: {\n        fpd?: string\n        print?: boolean\n        overwrite?: boolean\n    } = { }\n) {\n    if (fpd) {\n        fp = path.join(fpd, fp)\n        fp_ = path.join(fpd, fp_)\n    } else if (!path.isAbsolute(fp) || !path.isAbsolute(fp_))\n        throw new Error(t('fp 和 fp_ 必须是绝对路径'))\n    \n    if (print)\n        console.log(t('重命名'), fp, '→', fp_)\n    \n    if (!overwrite && fexists(fp_))\n        throw new Error(t('文件已存在：') + fp_)\n    \n    await fsp.rename(fp, fp_)\n}\n\n\n/**\n    递归创建文件夹，确保 fpd 指向的文件夹存在  Create folders recursively, make sure the folder pointed to by fpd exists  \n    返回首个创建的文件夹或 undefined  Returns the first created folder or undefined\n    \n    - fpd: 文件夹完整路径  Folder full path\n    - options?:\n        - print?: `true`\n        - mode?: `'0o777'` */\nexport async function fmkdir (\n    fpd: string,\n    {\n        print = true,\n        mode,\n    }: {\n        print?: boolean\n        \n        /** `0o777` A file mode. If a string is passed, it is parsed as an octal integer. */\n        mode?: string | number\n    } = { }\n) {\n    assert(path.isAbsolute(fpd), t('fpd 必须是绝对路径: ') + fpd)\n    assert(fpd.endsWith('/'), t('fpd 必须以 / 结尾: ') + fpd)\n    \n    // CallingfsPromises.mkdir() when path is a directory that exists results in a rejection only when recursive is false.\n    const fpd_ = (\n        await fsp.mkdir(fpd, { recursive: true, mode })\n    )?.replaceAll('\\\\', '/')\n    \n    if (fpd_) {\n        if (print)\n            console.log(t('已创建文件夹'), fpd)\n    } else\n        if (print)\n            console.log(t('已存在文件夹'), fpd)\n    \n    return fpd_\n}\n\n\n/** 创建软链接  Create soft links  \n    - fp_real: 现在真实文件/文件夹的路径  current real file/directory path\n    - fp_link: 目标链接文件/文件夹的路径  target file/directory path */\nexport async function flink (\n    fp_real: string, \n    fp_link: string, \n    {\n        junction = false,\n        print = true \n    }: { \n        junction?: boolean\n        print?: boolean\n} = { }) {\n    assert(path.isAbsolute(fp_real) && path.isAbsolute(fp_link), t('fp 必须是绝对路径'))\n    \n    const is_fpd_real = fp_real.endsWith('/')\n    const is_fpd_link = fp_link.endsWith('/')\n    \n    assert(is_fpd_real === is_fpd_link, t('fp_real 和 fp_link 必须同为文件路径或文件夹路径'))\n    \n    if (fexists(fp_link))\n        throw new Error(t('存在同名') + (is_fpd_link ? t('文件夹') : t('文件')) + ': ' + fp_link + t('，无法创建链接'))\n    \n    if (print)\n        console.log(t('已将源文件 ') + fp_real + t(' 链接到 ') + fp_link)\n    \n    if (junction)\n        fsp.symlink(fp_real, fp_link, 'junction')\n    else\n        fsp.symlink(fp_real, fp_link, is_fpd_real ? 'dir' : 'file')\n}\n\n\nexport let fwatchers: Record<string, fs.FSWatcher> = { }\n\n/**\n    - fp: 文件或文件夹路径  path of file or directory\n    - callback: 文件修改时回调  called when modified\n    - exec: `true` 首次 watch 时执行 onchange  call callback when watch is executed\n    \n    创建的 fs.FSWatcher 保存在 watchers 中, 再次调用相同的 fp 会自动关闭已有的 watcher  \n    save fs.FSWatcher in watchers, subsequent call will auto close existing watcher for the same fp\n    \n    https://nodejs.org/dist/latest-v15.x/docs/api/fs.html#fs_fs_watch_filename_options_listener  \n    The listener callback gets two arguments (event, fname). \n        event is either 'rename' or 'change', and filename is the name of the file which triggered the event.\n        On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.\n    \n    The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of event. */\nexport async function fwatch (\n    fp: string,\n    onchange: (event: string, fname: string) => any, \n    { exec = true }: { exec?: boolean } = { }\n) {\n    if (!path.isAbsolute(fp))\n        throw new Error(t('fp 必须是完整路径'))\n    \n    const _watcher = fwatchers[fp]\n    if (_watcher)\n        _watcher.close()\n    \n    if (exec)\n        await onchange('change', fp.fname)\n    \n    const start = new Date().getTime()\n    \n    const debounced_onchange = debounce(\n        (event, fname) => {\n            if (new Date().getTime() - start < 800)\n                return\n            console.log(t('文件修改 (') + event + '): ' + fname)\n            onchange(event, path.normalize(fname))\n        },\n        500,\n        { leading: false, trailing: true }\n    )\n    \n    let watcher = fs.watch(fp, debounced_onchange)\n    watcher.on('error', error => {\n        console.error(error)\n    })\n    return fwatchers[fp] = watcher\n}\n\n\n/** 打开一个文件并搜索替换某个 pattern  open a file and replace certain pattern */\nexport async function freplace (fp: string, pattern: string | RegExp, replacement: string) {\n    await fwrite(\n        fp,\n        (await fread(fp))\n            .replaceAll(pattern, replacement)\n    )\n}\n\n/** 将文件编码转为 UTF-8  convert file encoding to UTF-8\n    - fp: 文件完整路径  file absolute path\n    - options?:\n        - dryrun?: `true`\n        - encoding?: `'auto'` */\nexport async function f2utf8 (fp: string, {\n    dryrun = true,\n    encoding = 'auto',\n}: {\n    dryrun?: boolean\n    encoding?: Encoding | 'auto'\n} = { }) {\n    const text = await fread(fp, { encoding })\n    if (dryrun) {\n        console.log(text.slice(0, 10000))\n        return\n    }\n    \n    const fp_bak = `${fp.fdir}${fp.fname.replace(/(.*?)(\\.[^.]+)?$/, '$1.bak$2')}`\n    if (!fexists(fp_bak))\n        await fcopy(fp, fp_bak)\n    \n    await fwrite(fp, text)\n}\n\n"]}

package/net.browser.d.ts

@@ -1,10 +1,23 @@
 import './prototype.browser.js';
+export interface BasicAuth {
+    type: 'basic';
+    username: string;
+    password: string;
+}
+export interface BearerAuth {
+    type: 'bearer';
+    token: string;
+}
 export interface RequestOptions {
-    method?: 'get' | 'post' | 'put' | 'head' | 'delete' | 'patch';
+    method?: 'GET' | 'POST' | 'PUT' | 'HEAD' | 'DELETE' | 'PATCH';
     queries?: Record<string, any>;
     headers?: Record<string, string>;
-    body?: string | object | HTMLFormElement;
+    body?: string | Record<string, any> | ArrayBufferView | ArrayBuffer | Blob | URLSearchParams | FormData;
     type?: 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data';
+    retries?: true | number;
+    timeout?: number;
+    auth?: BasicAuth | BearerAuth;
+    cookies?: Record<string, string>;
     cors?: boolean;
     by?: 'fetch' | 'GM_xmlhttpRequest';
 }
@@ -13,12 +26,23 @@ export interface RequestRawOptions extends RequestOptions {
 }
 /**
     - url: 可以只有 pathname 部分
-    - options:
-        - type: `'application/json'` 请求的 content-type 头 (如果有 body)
-        - by: `window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch'` 发起请求所使用的底层方法
-*/
+    - options?:
+        - method?: `有 body 时为 POST, 否则为 GET` 'GET' | 'POST' | ···
+        - queries?: 添加到 url 上的参数，是 Record<string, any>，true/false 会被转换为 0/1
+        - headers?: http 请求头
+        - body?: http 请求体，可以是 string, Record<string, any> (会自动 JSON.stringify), ArrayBuffer(View), Blob,
+            URLSearchParams (type 为 x-www-form-urlencoded), FormData (type 为 form-data)
+        - type?: `'application/json'` 有 body 时设置 http 请求头中的 content-type 头
+        - retries?: `false` 可以传入 true (默认 2 次) 或 重试次数
+        - timeout?: `5 * 1000`
+        - auth?: BasicAuth | BearerAuth
+        - raw?: `false` 传入后返回整个 response
+        - by: `window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch'` 发起请求所使用的底层方法 */
 export declare function request(url: string | URL): Promise<string>;
 export declare function request(url: string | URL, options: RequestRawOptions): Promise<Response>;
+export declare function request(url: string | URL, options: RequestOptions & {
+    encoding: 'binary';
+}): Promise<ArrayBuffer>;
 export declare function request(url: string | URL, options: RequestOptions): Promise<string>;
 /** 发起 http 请求并将响应体作为 json 解析 */
 export declare function request_json<T = any>(url: string, options?: RequestOptions): Promise<T>;
@@ -34,7 +58,7 @@ export declare class WebSocketConnectionError extends Error {
         - protocols?
         - on_message: 根据 websocket frame 的 opcode 不同 (text frame 或 binary frame)，event 中的 data 对应为 ArrayBuffer 或者 string
           https://datatracker.ietf.org/doc/html/rfc6455#section-5.2
-        - on_close?
+        - on_close?: https://developer.mozilla.org/en-US/docs/Web/API/CloseEvent#Status_codes
         - on_error? */
 export declare function connect_websocket(url: string | URL, { protocols, on_close, on_error, on_message }: {
     protocols?: string | string[];

package/net.browser.js

@@ -1,8 +1,25 @@
 /// <reference types='tampermonkey' />
 import { t } from './i18n/instance.js';
 import './prototype.browser.js'; // to_time_str()
-import { assert, concat, genid } from './utils.browser.js';
-export async function request(url, { method, queries, headers, body, type = 'application/json', cors, by = window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch', raw, } = {}) {
+import { assert, concat, genid, delay } from './utils.browser.js';
+async function fetch_retry(url, options, timeout, retries = 0, count = 0) {
+    try {
+        options.signal = AbortSignal.timeout(timeout);
+        return await fetch(url, options);
+    }
+    catch (error) {
+        if (count >= retries ||
+            error.name !== 'TimeoutError' && !['ECONNRESET', 'ETIMEDOUT', 'ESOCKETTIMEDOUT'].includes(error.cause?.code))
+            throw error;
+        else {
+            const duration = 2 ** count;
+            console.log(`${`${'等待'} ${duration} ${t('秒后重试')} fetch (${count}) …`.yellow}  ${url.toString().blue.underline}`);
+            await delay(1000 * duration);
+            return fetch_retry(url, options, timeout, retries, count + 1);
+        }
+    }
+}
+export async function request(url, { method, queries, headers, body, type = 'application/json', retries, timeout = 5 * 1000, auth, raw = false, cors, by = window.GM_xmlhttpRequest ? 'GM_xmlhttpRequest' : 'fetch', } = {}) {
     url = new URL(url, location.href);
     if (queries)
         for (const key in queries) {
@@ -11,47 +28,85 @@ export async function request(url, { method, queries, headers, body, type = 'app
                 value = value ? '1' : '0';
             url.searchParams.append(key, value);
         }
-    if (body && !method)
-        method = 'post';
-    if (type === 'application/json' && typeof body !== 'undefined' && typeof body !== 'string')
-        body = JSON.stringify(body);
-    url = url.toString();
+    if (body !== undefined && !method)
+        method = 'POST';
+    if (retries === true)
+        retries = 2;
     if (by === 'fetch') {
-        const options = {
-            ...method ? { method: method.toUpperCase() } : {},
-            ...cors ? { mode: 'cors' } : {},
+        let options = {
+            ...method ? { method } : {},
+            keepalive: true,
+            redirect: 'follow',
             credentials: 'include',
+            ...cors ? { mode: 'cors' } : {},
             headers: {
-                ...body ? { 'content-type': type } : {},
-                ...headers,
+                ...body === undefined ? {} : { 'Content-Type': type },
+                ...auth ?
+                    { Authorization: auth.type === 'basic' ? `Basic ${`${auth.username}:${auth.password}`.to_base64()}` : `Bearer ${auth.token}` }
+                    :
+                        {},
+                ...headers ?
+                    Object.fromEntries(Object.entries(headers)
+                        .filter(([key, value]) => !key.startsWith(':'))) : {}
             },
-            ...body ? { body: body } : {},
+            // --- body
+            body: (() => {
+                if (body === undefined)
+                    return;
+                switch (type) {
+                    case 'application/json':
+                        return typeof body === 'string' ||
+                            ArrayBuffer.isView(body) ||
+                            body instanceof ArrayBuffer ||
+                            body instanceof Blob ?
+                            body
+                            :
+                                JSON.stringify(body);
+                    case 'application/x-www-form-urlencoded':
+                        return body instanceof URLSearchParams ? body : new URLSearchParams(body);
+                    case 'multipart/form-data':
+                        if (body instanceof FormData)
+                            return body;
+                        else {
+                            let form = new FormData();
+                            for (const key in body) {
+                                let value = body[key];
+                                form.set(key, value);
+                            }
+                            return form;
+                        }
+                }
+            })(),
         };
-        const response = await fetch(url, options);
+        let response = await fetch_retry(url, options, timeout, retries);
         if (!response.ok)
-            throw Object.assign(new Error(`StatusCodeError: ${response.status}`), { url, response, ...options });
+            throw Object.assign(new Error(`${t('状态码')} ${response.status}, ${t('非')} 2xx`), { name: 'StatusCodeError', url, options, response });
         if (raw)
             return response;
+        if (!response.body)
+            return response.body;
         return response.text();
     }
-    return new Promise((resolve, reject) => {
-        GM_xmlhttpRequest({
-            ...method ? { method: method.toUpperCase() } : {},
-            url: url,
-            headers: {
-                ...body ? { 'content-type': type } : {},
-                ...headers,
-            },
-            ...body ? { data: body, } : {},
-            onload(response) {
-                if (!(200 <= response.status && response.status <= 299)) {
-                    reject(Object.assign(new Error(`StatusCodeError: ${response.status}`), { url, queries, method, headers, body, response }));
-                    return;
+    else
+        return new Promise((resolve, reject) => {
+            const options = {
+                ...method ? { method: method } : {},
+                url: url.toString(),
+                headers: {
+                    ...body ? { 'content-type': type } : {},
+                    ...headers,
+                },
+                ...body ? { data: body } : {},
+                onload(response) {
+                    if (!(200 <= response.status && response.status <= 299)) {
+                        reject(Object.assign(new Error(`${t('状态码')} ${response.status}, ${t('非')} 2xx`), { name: 'StatusCodeError', url, options, response }));
+                        return;
+                    }
+                    resolve(response.responseText);
                 }
-                resolve(response.responseText);
-            }
+            };
+            GM_xmlhttpRequest(options);
         });
-    });
 }
 /** 发起 http 请求并将响应体作为 json 解析 */
 export async function request_json(url, options) {
@@ -83,7 +138,7 @@ export class WebSocketConnectionError extends Error {
         - protocols?
         - on_message: 根据 websocket frame 的 opcode 不同 (text frame 或 binary frame)，event 中的 data 对应为 ArrayBuffer 或者 string
           https://datatracker.ietf.org/doc/html/rfc6455#section-5.2
-        - on_close?
+        - on_close?: https://developer.mozilla.org/en-US/docs/Web/API/CloseEvent#Status_codes
         - on_error? */
 export async function connect_websocket(url, { protocols, on_close, on_error, on_message }) {
     let websocket = new WebSocket(url, protocols);