---
url: /typescript-api/interfaces/JsOpenOptions.md
---
[@sheetkit/node](../globals.md) / JsOpenOptions

# Interface: JsOpenOptions

Defined in: [packages/sheetkit/binding.d.ts:850](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L850)

Options for controlling how a workbook is opened and parsed.

## Properties

### auxParts?

> `optional` **auxParts?**: `string`

Defined in: [packages/sheetkit/binding.d.ts:884](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L884)

Auxiliary parts loading policy: "deferred" or "eager".
When "deferred", auxiliary parts (comments, charts, images, etc.) are
not parsed during open and are loaded on demand.
Default: "deferred".

***

### compressionRatioFloorBytes?

> `optional` **compressionRatioFloorBytes?**: `number`

Defined in: [packages/sheetkit/binding.d.ts:859](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L859)

Decompressed entry size at or below which the compression ratio is
not enforced. Default: 8 MiB. `0` enforces the ratio for every entry.

***

### cryptLimits?

> `optional` **cryptLimits?**: [`JsCryptLimits`](JsCryptLimits.md)

Defined in: [packages/sheetkit/binding.d.ts:869](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L869)

Finite encryption-container and password-derivation limits.

***

### dateInterpretation?

> `optional` **dateInterpretation?**: `string`

Defined in: [packages/sheetkit/binding.d.ts:898](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L898)

Controls how date-formatted number cells are interpreted when the
cell carries `t="n"` (or is untyped). Accepts `"numFmt"` (default,
promote `t="n"` cells whose style references a built-in date numFmt
ID 14-22/45-47, or a custom format code containing date/time tokens,
to a date cell) or `"cellType"` (spec-literal: only `t="d"` becomes
a date). Other values are rejected.

***

### maxOuterInputBytes?

> `optional` **maxOuterInputBytes?**: `number`

Defined in: [packages/sheetkit/binding.d.ts:852](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L852)

Maximum bytes accepted from an outer ZIP or encrypted container.

***

### maxUnzipSize?

> `optional` **maxUnzipSize?**: `number`

Defined in: [packages/sheetkit/binding.d.ts:865](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L865)

Maximum total decompressed size of all ZIP entries in bytes.

***

### maxXmlPartBytes?

> `optional` **maxXmlPartBytes?**: `number`

Defined in: [packages/sheetkit/binding.d.ts:854](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L854)

Maximum bytes read from one XML part, including lazy hydration.

***

### maxZipEntries?

> `optional` **maxZipEntries?**: `number`

Defined in: [packages/sheetkit/binding.d.ts:867](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L867)

Maximum number of ZIP entries allowed.

***

### parseMode?

> `optional` **parseMode?**: `string`

Defined in: [packages/sheetkit/binding.d.ts:889](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L889)

Backward-compatible alias for read_mode. "readfast" maps to "lazy",
"full" maps to "eager". Ignored when read_mode is set.

***

### readMode?

> `optional` **readMode?**: `string`

Defined in: [packages/sheetkit/binding.d.ts:877](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L877)

Read mode: "eager", "lazy" (default for async-first surface), or "stream".
Lazy skips auxiliary parts for faster read-only workloads.
Stream is reserved for future use and currently behaves like lazy.

***

### sheetRows?

> `optional` **sheetRows?**: `number`

Defined in: [packages/sheetkit/binding.d.ts:861](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L861)

Maximum rows read per sheet. Omit to use the worksheet format maximum.

***

### sheets?

> `optional` **sheets?**: `string`\[]

Defined in: [packages/sheetkit/binding.d.ts:863](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L863)

Only parse sheets whose names are in this list. Omit to parse all sheets.

***

### vbaLimits?

> `optional` **vbaLimits?**: [`JsVbaLimits`](JsVbaLimits.md)

Defined in: [packages/sheetkit/binding.d.ts:871](https://github.com/Nebu1eto/sheetkit/blob/aedd8c0c4ec37185210740b875ec6bb714d323d4/packages/sheetkit/binding.d.ts#L871)

Finite VBA project loading limits.
