原文链接: https://frida.re/docs/javascript-api/#iostream
欢迎加入 Frida 交流群: 1049977261

IOStream

所有的方法都是完全异步的, 并且返回 Promise 对象.

• input: 用于读取的 InputStream.

• output: 用于写入的 OutputStream.

• close():
  关闭这个流, 释放相关的资源. 这将同样的关闭独立的输入与输出流.
  一旦这个流被关闭, 所有其他的操作都将失败.
  您可以多次关闭同一个流, 并且不会造成任何异常.

InputStream

所有的方法都是完全异步的, 并且返回 Promise 对象.

• close():
  关闭这个流, 释放相关的资源.
  一旦这个流被关闭, 所有其他的操作都将失败.
  您可以多次关闭同一个流, 并且不会造成任何异常.

• read(size):
  从流中读取最多 size 个字节.
  返回一个接受最多 size 个字节的 ArrayBuffer 的 Promise 对象.
  空的缓冲区标志着流的终止.

• readAll(size):
  持续从流中读取直到 size 个字节被消费掉.
  返回一个接受 size 个字节的 ArrayBuffer 的 Promise 对象.
  过早的异常或流的终止将导致 Promise 以一个异常被拒绝, 这个异常对象的 partialData 属性包含着不完整的数据.

OutputStream

所有的方法都是完全异步的, 并且返回 Promise 对象.

• close():
  关闭这个流, 释放相关的资源.
  一旦这个流被关闭, 所有其他的操作都将失败.
  您可以多次关闭同一个流, 并且不会造成任何异常.

• write(data):
  试着向流中写入 data.
  data 的值要么是一个 ArrayBuffer 对象, 要么是由 0 ~ 255 组成的数组.
  返回一个接受数字的 Promise 对象, 指明 data 中的多少个字节已被写入流中.

• writeAll(data):
  持续向流中写入直到 data 被写完.
  data 的值要么是一个 ArrayBuffer 对象, 要么是由 0 ~ 255 组成的数组.
  过早的异常或流的终止将导致 Promise 以一个异常被拒绝, 这个异常对象的 partialSize 属性指明了异常出现时 data 中已被写入到流中的字节数.

UnixInputStream

(只可用于基于 UNIX 的操作系统)

• new UnixInputStream(fd[, options]):
  从指定的文件描述符 fd 创建一个新的 InputStream.

  您也可以提供一个 options 对象, 将其 autoClose 属性设为 true 以便在流被释放时自动关闭底层的文件描述符.
  您也可以通过调用 close() 或等待接下来的垃圾回收完成这一功能.

UnixOutputStream

(只可用于基于 UNIX 的操作系统)

• new UnixOutputStream(fd[, options]):
  从指定的文件描述符 fd 创建一个新的 OutputStream.

  您也可以提供一个 options 对象, 将其 autoClose 属性设为 true 以便在流被释放时自动关闭底层的文件描述符.
  您也可以通过调用 close() 或等待接下来的垃圾回收完成这一功能.

Win32InputStream

(只可用于 Windows 操作系统)

• new Win32InputStream(handle[, options]):
  从指定的 Windows HANDLE handle 创建一个新的 InputStream.

  您也可以提供一个 options 对象, 将其 autoClose 属性设为 true 以便在流被释放时自动关闭底层的文件描述符.
  您也可以通过调用 close() 或等待接下来的垃圾回收完成这一功能.

Win32OutputStream

(只可用于 Windows 操作系统)

• new Win32OutputStream(handle[, options]):
  从指定的 Windows HANDLE handle 创建一个新的 OutputStream.

  您也可以提供一个 options 对象, 将其 autoClose 属性设为 true 以便在流被释放时自动关闭底层的文件描述符.
  您也可以通过调用 close() 或等待接下来的垃圾回收完成这一功能.