bitburner-src/markdown/bitburner.singularity.workforfaction.md
Snarling 65cd14e33b
DOC: Add ns documentation for possible sleeve tasks ()
* Add specific types for sleeve tasks
* Moved LocationName enum to overall enums file
* Add LocationName enum to those provided to player
* remove trailing s on CompanyPosNames enum (now CompanyPosName, in line with LocationName)
* Also regenerated all ns documentation. This leads to an expected error when checking for generated files, because PRs should not normally touch markdown files. Also leads to a lint failure in generated file bitburner.d.ts
* also removed some exporting from NetscriptDefinitions.d.ts for anything that wasn't imported somewhere else.
2022-11-20 12:07:22 -05:00

59 lines
1.9 KiB
Markdown

<!-- Do not edit this file. It is automatically generated by API Documenter. -->
[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [Singularity](./bitburner.singularity.md) &gt; [workForFaction](./bitburner.singularity.workforfaction.md)
## Singularity.workForFaction() method
Work for a faction.
<b>Signature:</b>
```typescript
workForFaction(faction: string, workType: FactionWorkType | `${FactionWorkType}`, focus?: boolean): boolean;
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
| faction | string | Name of faction to work for. |
| workType | [FactionWorkType](./bitburner.factionworktype.md) \| \`${[FactionWorkType](./bitburner.factionworktype.md)<!-- -->}\` | Type of work to perform for the faction. |
| focus | boolean | Acquire player focus on this work operation. Optional. Defaults to true. |
<b>Returns:</b>
boolean
True if the player starts working, and false otherwise.
## Remarks
RAM cost: 3 GB \* 16/4/1
This function will set you to start working for the specified faction. You must be a member of the faction and that faction must have the specified work type, or else this function will fail. If you are already in the middle of some “working” action (such as working for a company, training at a gym, or creating a program), then running this function will cancel that action.
This function will return true if you successfully start working for the specified faction, and false otherwise.
## Example 1
```js
// NS1
var FACTION_NAME = "CyberSec", WORK_TYPE = "hacking";
var success = singularity.workForFaction(FACTION_NAME, WORK_TYPE);
if (!success) tprint("ERROR: Failed to start work for " + FACTION_NAME + " with work type " + WORK_TYPE);
```
## Example 2
```js
// NS2
const FACTION_NAME = "CyberSec", WORK_TYPE = "hacking";
let success = ns.singularity.workForFaction(FACTION_NAME, WORK_TYPE);
if (!success) ns.tprint(`ERROR: Failed to start work for ${FACTION_NAME} with work type ${WORK_TYPE}.`)
```