Google Apps Script의 다형 함수 문서

Question

두 번째 매개 변수가 제공되었는지 여부에 따라 라이브러리 기능이 두 가지 방식으로 작동하게하고 싶습니다. 당신은했습니다 http://googleappsdeveloper.blogspot.de/2012/05/introducing-versions-and-libraries-in.html

Answer 1

:

이 문서에서는이 문제를 포함하지 않습니다 지금은 그것을 문서화하는 방법을

function sheet_to_dict(a, b) { 
    var array = (
    b ? SpreadsheetApp.openById(a).getSheetByName(b) : a 
).getDataRange().getValues(); 

그것처럼 보이게하기 위해 예를 들면 다음과 같습니다
Apps 스크립트에서 작동 할 수있는 jsdoc 태그의 일부가 제한되어 있으며 이는 서비스 설명서에서 볼 수있는 결과를 복제 할 방법이없는 한 가지 예입니다. Here's a list of reported issues with the support of jsdoc in apps-script.

apps-script에서 수행 할 수있는 유일한 작업은 주석에 선택적 매개 변수에 대한 자세한 문서를 제공하는 것입니다. 불행히도 자동 완료 기능을 사용하면 도움이되지 않습니다.

@param 태그의 출력을 시뮬레이트하기 위해 html 테이블을 사용하는 How to preview jsdoc comments in google doc scripts을 기반으로하는 예제가 있으며 메소드의 두 가지 변형을 문서화합니다. 스크린 샷은 도서관 설명서 URL https://script.google.com/macros/library/d/<Library-Id>/<ver>에서 가져온 것입니다.

/** 
* Does incredible things, in a number of amazing ways. 
* 
* <pre> 
* jsdocTest(var1, var2) 
* </pre> 
* Description of the first variant. 
* <table><tbody> 
* <tr><td style="width: 20%"><b>Parameter</b></td><td style="width: 15%"><b>Type</b></td><td style="width: 65%"><b>Description</b></td></tr> 
* <tr><td> var1 </td><td> number </td><td> Description of Number Parameter </td></tr> 
* <tr><td> var2 </td><td> string </td><td> Description of String Parameter </td></tr> 
* </tbody></table> 
* 
* <pre> 
* jsdocTest(var3, var4) 
* </pre> 
* Description of the second variant. 
* <table><tbody> 
* <tr><td style="width: 20%"><b>Parameter</b></td><td style="width: 15%"><b>Type</b></td><td style="width: 65%"><b>Description</b></td></tr> 
* <tr><td> var3 </td><td> Object </td><td> Description of Object parameter </td></tr> 
* <tr><td> var4 </td><td> String [] </td><td> Description of String Array </td></tr> 
* </tbody></table> 
*/ 
function jsdocTest() { 
    // Handle all parameters via arguments[] 
}