options
{Object}encoding
{string} 用于解释结果字符串的字符编码。如果将encoding
设置为'buffer'
,则username
、shell
和homedir
的值将会是Buffer
实例。默认值:'utf8'
。
- 返回: {Object}
返回关于当前有效用户的信息。
在 POSIX 平台上,这通常是密码文件的子集。
返回的对象包含 username
、uid
、gid
、shell
和 homedir
。
在 Windows 上,则 uid
和 gid
字段为 -1
,且 shell
为 null
。
os.userInfo()
返回的 homedir
的值由操作系统提供。
这与 os.homedir()
的结果不同,其是在返回操作系统的响应之前会先查询主目录的环境变量。
如果用户没有 username
或 homedir
,则抛出 [SystemError
]。