tools: add [src] links to child-process.html

handle exports. as an alternative to module.exports
PR-URL: #22706
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: James M Snell <jasnell@gmail.com>

Author: rubys

test/fixtures/apilinks/exports.js

@@ -0,0 +1,13 @@
+'use strict';
+
+// Support `exports` as an alternative to `module.exports`.
+
+functionBuffer(){};
+
+exports.Buffer=Buffer;
+exports.fn1=functionfn1(){};
+
+varfn2=exports.fn2=function(){};
+
+functionfn3(){};
+exports.fn3=fn3;

test/fixtures/apilinks/exports.json

@@ -0,0 +1,6 @@
+{
+"exports.Buffer": "exports.js#L5",
+"exports.fn1": "exports.js#L8",
+"exports.fn2": "exports.js#L10",
+"exports.fn3": "exports.js#L12"
+}

tools/doc/apilinks.js

@@ -61,6 +61,7 @@ process.argv.slice(2).forEach((file) => {
 
 // Scan for exports.
 constexported={constructors: [],identifiers: []};
+constindirect={};
 program.forEach((statement)=>{
 if(statement.type==='ExpressionStatement'){
 constexpr=statement.expression;
@@ -69,35 +70,52 @@ process.argv.slice(2).forEach((file) => {
 letlhs=expr.left;
 if(expr.left.object.type==='MemberExpression')lhs=lhs.object;
 if(lhs.type!=='MemberExpression')return;
-if(lhs.object.name!=='module')return;
-if(lhs.property.name!=='exports')return;
-
-letrhs=expr.right;
-while(rhs.type==='AssignmentExpression')rhs=rhs.right;
-
-if(rhs.type==='NewExpression'){
-exported.constructors.push(rhs.callee.name);
-}elseif(rhs.type==='ObjectExpression'){
-rhs.properties.forEach((property)=>{
-if(property.value.type==='Identifier'){
-exported.identifiers.push(property.value.name);
-if(/^[A-Z]/.test(property.value.name[0])){
-exported.constructors.push(property.value.name);
-}
+if(lhs.object.name==='exports'){
+constname=lhs.property.name;
+if(expr.right.type==='FunctionExpression'){
+definition[`${basename}.${name}`]=
+`${link}#L${statement.loc.start.line}`;
+}elseif(expr.right.type==='Identifier'){
+if(expr.right.name===name){
+indirect[name]=`${basename}.${name}`;
 }
-});
-}elseif(rhs.type==='Identifier'){
-exported.identifiers.push(rhs.name);
+}else{
+exported.identifiers.push(name);
+}
+}elseif(lhs.object.name==='module'){
+if(lhs.property.name!=='exports')return;
+
+letrhs=expr.right;
+while(rhs.type==='AssignmentExpression')rhs=rhs.right;
+
+if(rhs.type==='NewExpression'){
+exported.constructors.push(rhs.callee.name);
+}elseif(rhs.type==='ObjectExpression'){
+rhs.properties.forEach((property)=>{
+if(property.value.type==='Identifier'){
+exported.identifiers.push(property.value.name);
+if(/^[A-Z]/.test(property.value.name[0])){
+exported.constructors.push(property.value.name);
+}
+}
+});
+}elseif(rhs.type==='Identifier'){
+exported.identifiers.push(rhs.name);
+}
 }
 }elseif(statement.type==='VariableDeclaration'){
 for(constdeclofstatement.declarations){
 letinit=decl.init;
 while(init&&init.type==='AssignmentExpression')init=init.left;
 if(!init||init.type!=='MemberExpression')continue;
-if(init.object.name!=='module')continue;
-if(init.property.name!=='exports')continue;
-exported.constructors.push(decl.id.name);
-definition[decl.id.name]=`${link}#L${statement.loc.start.line}`;
+if(init.object.name==='exports'){
+definition[`${basename}.${init.property.name}`]=
+`${link}#L${statement.loc.start.line}`;
+}elseif(init.object.name==='module'){
+if(init.property.name!=='exports')continue;
+exported.constructors.push(decl.id.name);
+definition[decl.id.name]=`${link}#L${statement.loc.start.line}`;
+}
 }
 }
 });
@@ -107,10 +125,8 @@ process.argv.slice(2).forEach((file) => {
 // ClassName.foo = ...;
 // ClassName.prototype.foo = ...;
 // function Identifier(...) {...};
-// class Foo {...}
+// class Foo {...};
 //
-constindirect={};
-
 program.forEach((statement)=>{
 if(statement.type==='ExpressionStatement'){
 constexpr=statement.expression;