fs.symlink(target, path[, type], callback)
target
<string> | <Buffer> | <URL>path
<string> | <Buffer> | <URL>type
<string>callback
<Function>err
<Error>
除了可能的异常之外,没有为完成回调提供任何参数。
type
参数仅在 Windows 上可用,在其他平台上被忽略。
可以设置为 'dir'
、'file'
或 'junction'
。
如果未设置 type
参数,Node.js 将自动检测 target
类型并使用 'file'
或 'dir'
。
如果 target
不存在,将使用 'file'
。
Windows 交接点要求目标路径是绝对路径。
使用 'junction'
时,target
参数将自动规范化为绝对路径。
相对目标相对于链接的父目录。
fs.symlink('./mew', './example/mewtwo', callback);
上面的示例在 example
中创建符号链接 mewtwo
,其指向同一个目录中的 mew
:
$ tree example/
example/
├── mew
└── mewtwo -> ./mew
target
<string> | <Buffer> | <URL>path
<string> | <Buffer> | <URL>type
<string>callback
<Function>err
<Error>
Asynchronous symlink(2)
which creates the link called path
pointing to
target
. No arguments other than a possible exception are given to the
completion callback.
The type
argument is only available on Windows and ignored on other platforms.
It can be set to 'dir'
, 'file'
, or 'junction'
. If the type
argument is
not set, Node.js will autodetect target
type and use 'file'
or 'dir'
. If
the target
does not exist, 'file'
will be used. Windows junction points
require the destination path to be absolute. When using 'junction'
, the
target
argument will automatically be normalized to absolute path.
Relative targets are relative to the link’s parent directory.
fs.symlink('./mew', './example/mewtwo', callback);
The above example creates a symbolic link mewtwo
in the example
which points
to mew
in the same directory:
$ tree example/
example/
├── mew
└── mewtwo -> ./mew