RangeError: Value undefined out of range for undefined options property undefined
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 15.5k
- Forks
- 1.5k
- Avg merge
- 10d 23h
- Merged PRs (30d)
- 1
Description
JSDoc debug output
.npm-global/lib64/node_modules/jsdoc/lib/jsdoc/util/doop.js:9
set.add(item);
RangeError: Value undefined out of range for undefined options property undefined.
Expected behavior
Attempting to apply JSDoc recursively to all files within a directory
Current behavior
Originally got "FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory" but after allocating more memory I would instead get the RangeError shown above. If I allocate 4gb of memory I get the FATAL ERROR but if I do more I get the RangeError.
Your environment
| Software | Version |
|---|---|
| JSDoc | 3.6.7 |
| Node.js | v16.13.0 |
| npm | 8.1.0 |
| Operating system | Gentoo |
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the recursive JSDoc run described in the issue with JSDoc 3.6.7 on Node.js v16.13.0, then inspect lib/jsdoc/util/doop.js at the reported set.add(item) location. Compare behavior under the reported memory limits and determine what completion should look like: recursive processing without the RangeError or heap exhaustion.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, node.js
- Domain
- cli, tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100