Node.js API详解之 V8模块用法实例分析

本文实例讲述了Node.js API详解之 V8模块用法。分享给大家供大家参考,具体如下:

Node.js API详解之 V8

v8 模块暴露了特定于V8版本内置到 Node.js 二进制文件中的API. 通过以下方式使用:

const v8 = require('v8');

注意: APIs 和实现可能在任何时间变动。

v8.cachedDataVersionTag()

说明:

返回一个表示从V8版本,命令行标志和已检测到的CPU功能派生的“version tag”的整数。
这对于判断vm.Script cachedData是否兼容当前v8实例非常有用。

demo:

const v8 = require('v8');
console.log( v8.cachedDataVersionTag() );
// 2299951209

v8.getHeapSpaceStatistics()

说明:

返回关于v8堆空间的统计,即组成v8堆的片段。
通过V8 GetHeapSpaceStatistics 函数提供统计信息,无论堆空间的顺序,或是堆空间的可用性都可以被保证,并且可能是多个V8版本。

demo:

const v8 = require('v8');
console.log( v8.getHeapSpaceStatistics() );
// [ { space_name: 'new_space',
//   space_size: 2097152,
//   space_used_size: 706992,
//   space_available_size: 324176,
//   physical_space_size: 2051712 },
//  { space_name: 'old_space',
//   space_size: 2420736,
//   space_used_size: 2325072,
//   space_available_size: 176,
//   physical_space_size: 2368592 } ]

v8.getHeapStatistics()

说明:

返回拥有以下参数的对象:
total_heap_size
total_heap_size_executable
total_physical_size
total_available_size
used_heap_size
heap_size_limit
malloced_memory
peak_malloced_memory
does_zap_garbage
does_zap_garbage是个0/1式布尔值,它凸显是否设置了–zap_code_space选项。
若为真,那么V8引擎会用一个位模式来覆盖堆中的垃圾。
如此,RSS(常驻内存集)会变得越来越大,因为V8会一直征用所有的堆页,从而让他们更难被操作系统交换掉。

demo:

const v8 = require('v8');
console.log( v8.getHeapStatistics() );
// { total_heap_size: 7159808,
//  total_heap_size_executable: 3670016,
//  total_physical_size: 6020992,
//  total_available_size: 1492618992,
//  used_heap_size: 4550336,
//  heap_size_limit: 1501560832,
//  malloced_memory: 8192,
//  peak_malloced_memory: 1185928,
//  does_zap_garbage: 0 }

v8.setFlagsFromString(string)

说明:

v8.setFlagsFromString()可以被用来在脚本中设置V8引擎的命令行标识。此方法应该谨慎使用。
在虚拟机已经运行后修改其设置可能会造成不可预测的结果,包括崩溃和数据丢失,或者一点作用也没有。
针对一个特定版本的Node.js,可供其使用的V8选项可以通过运行node –v8-options来获取。
一个非官方的,由社区维护的选项清单及其效果可参见这里。

demo:

const v8 = require('v8');
v8.setFlagsFromString('mbp v8');

Serialization API

说明:

序列化API提供了一系列用于序列化JavaScript值的方法,它们兼容于HTML structured clone algorithm。
格式是向下兼容的(可以安心存储于硬盘中)。
注意: 此API正在开发中,任何变化(包括不兼容的API或者传输格式)可能会随时发生直到此警告被移除。

v8.serialize(value)

说明:

使用DefaultSerializer来序列化value到一个缓冲区中。

demo:

const v8 = require('v8');
console.log( v8.serialize('isjs') );
//

v8.deserialize(buffer)

说明:

用默认配置来执行DefaultDeserializer从而从一个缓冲区中读取一个JS值

demo:

const v8 = require('v8');
const serializeVal = v8.serialize('isjs');
console.log( serializeVal );
//
console.log( v8.deserialize(serializeVal);
// isjs

class: v8.DefaultSerializer

说明:

Serializer的子类,用来将TypedArray(尤其是Buffer)和Dataview序列化成一个宿主对象,
并且对于它们底层的ArrayBuffer,只有被它们实际指向的部分会被存储起来。

class: v8.DefaultDeserializer

说明:

Deserializer的一个子类,根据DefaultSerializer的格式而定。

new Serializer()

说明:

创建一个新的Serializer对象。

serializer.writeHeader()

说明:

写出一个包含序列化格式版本的头文件

serializer.writeValue(value)

说明:

序列化一个JavaScript值并将结果加入内部的缓冲区。
如果value不能被序列化则抛出错误。

serializer.releaseBuffer()

说明:

返回存储里的内部缓冲区。若缓冲区已经被释放则不应该使用此序列化机制。
如果之前的一次写入操作失败,那么执行此方法会造成不可预知的行为。

serializer.transferArrayBuffer(id, arrayBuffer)

说明:

标记一个ArrayBuffer, 表明它的内容正在被带外传输中。
同时将ArrayBuffer包裹于一个反序列化的上下文内,之后将结果传入deserializer.transferArrayBuffer()中。

serializer.writeUint32(value)

说明:

写出一个原始32位无符号整型。
此方法在一个自定义的serializer._writeHostObject()中使用.

serializer.writeUint64(hi, lo)

说明:

写出一个原始64位无符号整型,会被拆分成高32位和低32位两部分。
此方法用于一个自定义的serializer._writeHostObject().

serializer.writeDouble(value)

说明:

写出一个JS的number值。 从方法用于一个自定义的serializer._writeHostObject().

serializer.writeRawBytes(buffer)

说明:

将原始字节写入序列化机制的内部缓冲区中。
反序列化机制会有对应的方法来获得缓冲区的长度。
此方法用于一个自定义的serializer._writeHostObject()中。

serializer._writeHostObject(object)

说明:

此方法用来写出某种宿主对象,进一步说,是由绑定的原生C++代码所生成的一个对象。
如果无法序列化object,那么一个恰当的异常会被抛出。
此方法在Serializer对象本身是不存在的,但可在其子类中提供。

serializer._getDataCloneError(message)

说明:

当一个对象无法被克隆时,会使用此方法来生成待抛出的错误对象。
此方法默认为Error的构造函数,可以在子类中被覆盖。

serializer._getSharedArrayBufferId(sharedArrayBuffer)

说明:

当序列化机制将要序列化一个ShareArrayBuffer对象时会调用此方法。
它必须为这对象返回一个32位无符号整型的ID,但若这个对象已被序列化过,则返回上一次序列化时所分配的ID。
这个ID会在对象被反序列化时传入deserializer.transferArrayBuffer()中。
如果对象不能被序列化,则抛出异常。
Serializer类本身不包含此方法,但可以在其子类中设置它。

serializer._setTreatArrayBufferViewsAsHostObjects(flag)

说明:

表明是否视TypedArray,DataView对象为宿主对象,也就是说,是否能将他们传入serializer._writeHostObject()中。
默认以上对象非宿主对象。

new Deserializer(buffer)

说明:

生成一个新的Deserializer对象。

deserializer.readHeader()

说明:

读取并验证一个头文件(包含格式信息)。
验证在某些情况下有可能不会通过,比如传输格式不合格或者不被支持。
若发生上述情况,那么一个Error会被抛出。

deserializer.readValue()

说明:

从缓冲区中反序列化一个JavaScript值,并返回它。

deserializer.transferArrayBuffer(id, arrayBuffer)

说明:

标记一个ArrayBuffer, 表明它的内容正在被带外传输中。
同时将ArrayBuffer包裹于一个序列化的上下文内,之后将结果传入serializer.transferArrayBuffer()中
(当arrayBuffer是ShareArrayBuffer实例时,返回serializer._getSharedArrayBufferId()产生的id)

deserializer.getWireFormatVersion()

说明:

读取底层的传输格式的版本。很可能有助于遗留代码来读取旧的传输格式版本。
不可在.readHeader()之前调用此方法。

deserializer.readUint32()

说明:

读取并返回一个原始32位无符号整型。
用于一个自定义的deserializer._readHostObject()。

deserializer.readUint64()

说明:

读取一个原始64位无符号整型,将其拆分成一个包含两个32位无符号整型的[hi, lo]数组,并返回此数组。
用于一个自定义的deserializer._readHostObject()。

deserializer.readDouble()

说明:

读取一个JSnumber值。 用于一个自定义的deserializer._readHostObject()。

deserializer.readRawBytes(length)

说明:

从反序列化机制的内部缓冲区中读取原始字节。length必须和传入serializer.writeRawBytes()中的缓冲区的长度相符。
用于一个自定义的serializer.writeRawBytes()。

deserializer._readHostObject()

说明:

此方法用来写出某种宿主对象,进一步说,是由绑定的原生C++代码所生成的一个对象。
如果无法序列化数据,那么一个恰当的异常会被抛出。
此方法在Deserializer对象本身上是不存在的,但可有其子类提供。

希望本文所述对大家node.js程序设计有所帮助。

时间: 2020-06-05

Node.js API详解之 module模块用法实例分析

本文实例讲述了Node.js API详解之 module模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 module Node.js 有一个简单的模块加载系统. 在 Node.js 中,文件和模块是一一对应的(每个文件被视为一个独立的模块). 例子,假设有一个名为 foo.js 的文件: const circle = require('./circle.js'); console.log(`半径为 4 的圆的面积是 ${circle.area(4)}`); 在第一行中,

Node.js API详解之 timer模块用法实例分析

本文实例讲述了Node.js API详解之 timer模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 timer timer 模块暴露了一个全局的 API,用于在某个未来时间段调用调度函数. 因为定时器函数是全局的,所以使用该 API 无需调用 require('timers'). Node.js 中的计时器函数实现了与 Web 浏览器提供的定时器类似的 API, 它使用了一个不同的内部实现,它是基于 Node.js 事件循环构建的. setImmediate(call

Node.js API详解之 tty功能与用法实例分析

本文实例讲述了Node.js API详解之 tty功能与用法.分享给大家供大家参考,具体如下: tty 可以理解为终端的意思.tty 模块提供终端相关的接口,用来获取终端的行数列数等. 通过 const tty = require('tty'); 的方式引用 tty 模块 process.stdout.isTTY 说明: 此属性位于 process 模块,用来判断 Node.js 是否运行在一个 TTY 环境中 demo: console.log(process.stdout.isTTY) //

Node.js API详解之 zlib模块用法分析

本文实例讲述了Node.js API详解之 zlib模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 zlib zlib模块提供通过 Gzip 和 Deflate/Inflate 实现的压缩功能,可以通过这样使用它: const zlib = require('zlib'); 压缩或者解压数据流(例如一个文件)通过zlib流将源数据流传输到目标流中来完成: const gzip = zlib.createGzip(); const fs = require('fs');

Node.js API详解之 os模块用法实例分析

本文实例讲述了Node.js API详解之 os模块用法.分享给大家供大家参考,具体如下: os是Node的一个基础模块,提供了一些操作系统相关的属性接口. 通过 const os = require('os'); 的方式引用os模块,我们接着看下os都有哪些功能 说明: 一个字符串常量,定义操作系统相关的行末标志:POSIX 系统上值为\n,Windows下的值为\r\n demo: console.log('abc'+ os.EOL +'123'); //abc //123 os.arch(

Node.js API详解之 assert模块用法实例分析

本文实例讲述了Node.js API详解之 assert模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 assert assert 模块提供了断言测试的函数,用于测试不变式. 断言是编程术语,表示为一些布尔表达式,程序员相信在程序中的某个特定点该表达式值为真, 可以在任何时候启用和禁用断言验证,因此可以在测试时启用断言而在部署时禁用断言. 同样,程序投入运行后,最终用户在遇到问题时可以重新启用断言. 使用断言可以创建更稳定.品质更好且不易于出错的代码. 当需要在一个值为

Node.js API详解之 readline模块用法详解

本文实例讲述了Node.js API详解之 readline模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 readline readline 模块提供了一个接口,用于从可读流(如 process.stdin)读取数据,每次读取一行. 它可以通过以下方式使用: const readline = require('readline'); readline 模块的基本用法: const readline = require('readline'); const rl = r

Node.js API详解之 querystring用法实例分析

本文实例讲述了Node.js API详解之 querystring用法.分享给大家供大家参考,具体如下: Node.js API详解之 querystring querystring模块提供了一些实用函数,用于解析与格式换URL查询字符串 通过 const querystring = require('querystring'); 的方式引用querystrings模块 目录: querystring.escape(str) querystring.unescape(str) querystri

Node.js API详解之 util模块用法实例分析

本文实例讲述了Node.js API详解之 util模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 util util 模块主要用于支持 Node.js 内部 API 的需求.提供了大部分实用工具. 通过 const util = require('util'); 的方式引用util模块 util.callbackify(original) 说明: original:传递一个 async 函数,或者是一个返回Promise的异步函数. callbackify会返回一个方

Node.js API详解之 Error模块用法实例分析

本文实例讲述了Node.js API详解之 Error模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 Error Node.js 中运行的应用程序一般会遇到以下四类错误: 1.标准的 JavaScript 错误: EvalError : 当调用 eval() 失败时抛出. SyntaxError : 当 JavaScript 语法错误时抛出. RangeError : 当值不在预期范围内时抛出. ReferenceError : 当使用未定义的变量时抛出. TypeEr

Node.js API详解之 vm模块用法实例分析

本文实例讲述了Node.js API详解之 vm模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 vm vm 模块提供了一系列 API 用于在 V8 虚拟机环境中编译和运行代码. JavaScript 代码可以被编译并立即运行,或编译.保存然后再运行. 常见的用法是在沙盒中运行代码.沙盒代码使用不同的V8上下文. const vm = require('vm'); const x = 1; const sandbox = { x: 2 }; vm.createContex

Node.js API详解之 string_decoder用法实例分析

本文实例讲述了Node.js API详解之 string_decoder用法.分享给大家供大家参考,具体如下: string_decoder 模块提供了一个 API,用于把 Buffer 对象解码成字符串. 对于参数末尾不完整的多字节字符,string_decoder会将其保存在内部的buffer中,当再次解码时,补充到参数开头. 通过 const { StringDecoder } = require('string_decoder'); 的方式引用string_decoder模块. 目录:

Node.js API详解之 net模块实例分析

本文实例讲述了Node.js API详解之 net模块.分享给大家供大家参考,具体如下: Node.js API详解之 net net 模块提供了创建基于流的 TCP 或 IPC 服务器(net.createServer())和客户端(net.createConnection()) 的异步网络 API. 通过以下方式引入: const net = require('net'); net.isIP(input) 说明: 测试 input 是否是 IP 地址.无效的字符串则返回 0,IPv4 地址则

Node.js API详解之 console模块用法详解

本文实例讲述了Node.js API详解之 console模块用法.分享给大家供大家参考,具体如下: console模块简介 说明: console 模块提供了一个简单的调试控制台,类似于 Web 浏览器提供的 JavaScript 控制台. console 模块导出了两个特定的组件: 一个 Console 类,包含 console.log() . console.error() 和 console.warn() 等方法,可以被用于写入到任何 Node.js 流. 一个全局的 console 实

Node.js API详解之 dgram模块用法实例分析

本文实例讲述了Node.js API详解之 dgram模块用法.分享给大家供大家参考,具体如下: Node.js API详解之 dgram dgram模块提供了 UDP 数据包 socket 的实现. 使用以下方式引用: const dgram = require('dgram'); dgram.createSocket(options[, callback]) 说明: 创建一个 dgram.Socket 对象. 一旦创建了套接字,调用 socket.bind() 会指示套接字开始监听数据报消息