bitburner-src/markdown/bitburner.ns.prompt.md
Olivier Gagnon ceb2a48d9f update doc
2022-03-17 16:50:46 -04:00

1.4 KiB
Raw Blame History

Home > bitburner > NS > prompt

NS.prompt() method

Prompt the player with an input modal.

Signature:

prompt(
    txt: string,
    options?: { type?: "boolean" | "text" | "select" | undefined; choices?: string[] },
  ): Promise<boolean | string>;

Parameters

Parameter Type Description
txt string Text to appear in the prompt dialog box.
options { type?: "boolean" | "text" | "select" | undefined; choices?: string[] } Options to modify the prompt the player is shown.

Returns:

Promise<boolean | string>

True if the player click “Yes”; false if the player clicks “No”; or the value entered by the player.

Remarks

RAM cost: 0 GB

Prompts the player with a dialog box. If options.type is undefined or "boolean", the player is shown "Yes" and "No" prompts, which return true and false respectively. Passing a type of "text" will give the player a text field and a value of "select" will show a drop-down field. Choosing type "select" will require an array or object to be passed via the options.choices property. The scripts execution is halted until the player selects one of the options.