I had a whole bunch of source files that caused jsdoc2md to throw RangeError: Maximum call stack size exceeded. when I attempted to render them. I managed to reduce the issue down to this minimal reproduction (with v 5.0.3):
Foo.js:
/** */
export class Foo {
constructor() { }
}
template.hbs:
{{#class name="Foo"}}{{>docs}}{{/class}}
Result:
$ jsdoc2md --files ./Foo.js --template ./template.hbs RangeError: Maximum call stack size exceeded
It doesn't appear to matter whether or not there is content in the jsdoc block, it seems like the only things required to trigger it are a doc block before the class and the class must have a constructor.
More info, if it's helpful...$ jsdoc2md --version
5.0.3
$ jsdoc2md --files ./Foo.js --template ./template.hbs --config
{
"files": [
"./Foo.js"
],
"template": "./template.hbs"
}
$ jsdoc2md --files ./Foo.js --template ./template.hbs --json
[
{
"id": "Foo",
"longname": "Foo",
"name": "Foo",
"kind": "class",
"scope": "instance",
"memberof": "Foo",
"meta": {
"lineno": 1,
"filename": "Foo.js",
"path": "/Users/jasonk/jsdoc2md-repro"
},
"order": 0
}
]
$ jsdoc2md --files ./Foo.js --template ./template.hbs --jsdoc
[
{
"comment": "/** */",
"meta": {
"range": [
7,
44
],
"filename": "Foo.js",
"lineno": 1,
"columnno": 7,
"path": "/Users/jasonk/jsdoc2md-repro",
"code": {
"id": "astnode100000002",
"name": "exports.Foo",
"type": "ClassDeclaration"
}
},
"name": "Foo",
"longname": "Foo",
"kind": "class",
"scope": "global",
"undocumented": true
},
{
"comment": "",
"meta": {
"range": [
14,
44
],
"filename": "Foo.js",
"lineno": 1,
"columnno": 14,
"path": "/Users/jasonk/jsdoc2md-repro",
"code": {
"id": "astnode100000003",
"name": "Foo",
"type": "ClassDeclaration",
"paramnames": []
}
},
"undocumented": true,
"name": "Foo",
"longname": "Foo",
"kind": "class",
"scope": "global"
},
{
"comment": "",
"meta": {
"range": [
26,
42
],
"filename": "Foo.js",
"lineno": 1,
"columnno": 26,
"path": "/Users/jasonk/jsdoc2md-repro",
"code": {
"id": "astnode100000006",
"name": "exports.Foo",
"type": "MethodDefinition",
"paramnames": []
},
"vars": {
"": null
}
},
"undocumented": true,
"name": "Foo",
"longname": "Foo#Foo",
"kind": "class",
"memberof": "Foo",
"scope": "instance",
"params": []
},
{
"comment": "",
"meta": {
"range": [
26,
42
],
"filename": "Foo.js",
"lineno": 1,
"columnno": 26,
"path": "/Users/jasonk/jsdoc2md-repro",
"code": {
"id": "astnode100000006",
"name": "exports.Foo",
"type": "MethodDefinition",
"paramnames": []
}
},
"name": "Foo",
"longname": "Foo",
"kind": "class",
"memberof": "Foo",
"scope": "instance"
},
{
"kind": "package",
"longname": "package:undefined",
"files": [
"/Users/jasonk/jsdoc2md-repro/Foo.js"
]
}
]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4