Módulo módulo básico

Módulo global

Obxectos globais, obxectos base accesibles a todos os scripts

Obxecto

Buffer

Obxecto de caché de datos binarios para io Ler e escribir o procesamento de datos, ver Buffer Obxecto.

1
Buffer global.Buffer;

console

Obxecto de acceso á consola

1
console global.console;

process

Obxecto de proceso

1
process global.process;

Función estática

run

Executa un script

1 2
static global.run(String fname, Array argv = []);

Parámetros de chamada:

  • fname: Cadea, especifique a ruta do script a executar
  • argv: Array, especifique o parámetro a executar, este parámetro pódese obter usando argv no script

require

Cargue un módulo e devolva o obxecto do módulo; consulte @ref module para obter máis información

1
static Value global.require(String id);

Parámetros de chamada:

  • id: Cadea, especifique o nome do módulo a cargar

Resultado de volta:

  • Value, Devolve o obxecto exportado do módulo cargado

require pódese usar para cargar módulos básicos e ficheiros.

O módulo básico é o módulo inicializado cando se crea o sandbox. Só precisa pasar o id correspondente cando se fai referencia, como require ("net").

O módulo de ficheiro é un módulo definido polo usuario e débese pasar un camiño relativo que comece por ./ ou ../ ao cotizar. O módulo de ficheiro admite .js, .jsc e .js.json documento.

O módulo de ficheiro tamén admite o formato package.json. Cando o módulo ten unha estrutura de directorio, require primeiro consultará o principal en package.json e, se non se atopa, intentará cargar index.js, index.jsc ou index. json no camiño.

Se o camiño de referencia non comeza con ./ ou ../ e non é un módulo básico, esixe buscar nódulos_modo baixo o camiño onde se atopa o módulo actual e recursivamente desde o directorio de nivel superior.

O proceso básico é o seguinte:

%0 start start is_native is internal module? start->is_native resolve path.resolve has_file module exists? resolve->has_file search recursive lookup node_modules from the current path search->has_file load load end end load->end is_native->end Yes is_mod is module? is_native->is_mod No is_mod->search Yes is_abs is absolute? is_mod->is_abs No is_abs->resolve No is_abs->has_file Yes has_file->load Yes has_ext module.js exists? has_file->has_ext No has_ext->load Yes has_package /package.json exists? has_ext->has_package No has_main main exists? has_package->has_main Yes has_index index.js exists? has_package->has_index No has_main->load Yes has_main->has_index No has_index->load Yes has_index->end No

setTimeout

Chama á función despois do tempo especificado

1 2 3
static Timer global.setTimeout(Function callback, Number timeout = 1, ...args);

Parámetros de chamada:

  • callback: Función, especifique a función de devolución de chamada
  • timeout: Número, especifica o tempo de atraso, en milisegundos. Se supera 2 ^ 31, executarase inmediatamente.
  • args: ..., parámetros adicionais, pasados ​​á devolución de chamada especificada, opcional.

Resultado de volta:

  • Timer, Devolve o obxecto temporizador

clearTimeout

Borrar o temporizador especificado

1
static global.clearTimeout(Value t);

Parámetros de chamada:

  • t: Valor, especifica o temporizador a borrar

setInterval

Chama á función despois de cada intervalo de tempo especificado

1 2 3
static Timer global.setInterval(Function callback, Number timeout, ...args);

Parámetros de chamada:

  • callback: Función, especifique a función de devolución de chamada
  • timeout: Número, o tempo do intervalo especificado, en milisegundos. Se supera 2 ^ 31, executarase inmediatamente.
  • args: ..., parámetros adicionais, pasados ​​á devolución de chamada especificada, opcional.

Resultado de volta:

  • Timer, Devolve o obxecto temporizador

clearInterval

Borrar o temporizador especificado

1
static global.clearInterval(Value t);

Parámetros de chamada:

  • t: Valor, especifica o temporizador a borrar

setHrInterval

A función chámase despois de cada intervalo de tempo especificado. Este é un temporizador de alta precisión que interromperá activamente o temporizador de execución de script JavaScript.

1 2 3
static Timer global.setHrInterval(Function callback, Number timeout, ...args);

Parámetros de chamada:

  • callback: Función, especifique a función de devolución de chamada
  • timeout: Número, o tempo do intervalo especificado, en milisegundos. Se supera 2 ^ 31, executarase inmediatamente.
  • args: ..., parámetros adicionais, pasados ​​á devolución de chamada especificada, opcional.

Resultado de volta:

  • Timer, Devolve o obxecto temporizador

Dado que o temporizador de setHrInterval interromperá o código en execución para executar a devolución de chamada, non modifique os datos que poidan afectar a outros módulos da función de devolución de chamada nin chame a ningunha función API marcada como asíncrona na devolución de chamada, se non, producirá resultados imprevisibles. Por exemplo:

1 2 3 4 5 6 7 8 9 10
var timers = require('timers'); var cnt = 0; timers.setHrInterval(() => { cnt++; }, 100); while (cnt < 10); console.error("===============================> done");

Neste código, o bucle da liña 8 non remata debido ao cambio de cnt, porque JavaScript determinará que cnt non se cambiará durante este ciclo ao optimizar o código.


clearHrInterval

Borrar o temporizador especificado

1
static global.clearHrInterval(Value t);

Parámetros de chamada:

  • t: Valor, especifica o temporizador a borrar

setImmediate

Execute a función de devolución de chamada inmediatamente no seguinte tempo libre

1 2
static Timer global.setImmediate(Function callback, ...args);

Parámetros de chamada:

  • callback: Función, especifique a función de devolución de chamada
  • args: ..., parámetros adicionais, pasados ​​á devolución de chamada especificada, opcional.

Resultado de volta:

  • Timer, Devolve o obxecto temporizador

clearImmediate

Borrar o temporizador especificado

1
static global.clearImmediate(Value t);

Parámetros de chamada:

  • t: Valor, especifica o temporizador a borrar

GC

Recollida de lixo obrigatoria

1
static global.GC();

Propiedades estáticas

Master

Worker, Worker Obxecto host, só en Worker O script de entrada é válido

1
static readonly Worker global.Master;

global

Obxecto, obxecto global

1
static readonly Object new global;

argv

Array, obtén os parámetros de execución do script actual, inicia js para obter os parámetros de inicio do proceso, o script executado por run obtén os parámetros pasados

1
static readonly Array global.argv;

__filename

Cadea, nome do ficheiro de script actual

1
static readonly String global.__filename;

__dirname

Cadea, o directorio onde se atopa o script actual

1
static readonly String global.__dirname;