1つの文字列パラメータを受け入れる関数があります。このパラメーターは、いくつかの定義可能な値のうちの1つのみを持つことができます。同じことを文書化する最良の方法は何ですか?shapeTypeは、列挙型、TypeDef、またはその他のものとして定義する必要がありますか?
Shape.prototype.create = function (shapeType) {
// shapeType can be "rect", "circle" or "ellipse"...
this.type = shapeType;
};
Shape.prototype.getType = function (shapeType) {
// shapeType can be "rect", "circle" or "ellipse"...
return this.type;
};
問題の2番目の部分は、の可能な値が、提案したものとしてshapeType
定義shapeType
されているファイルで不明であるということです。の可能な値に追加する可能性のある複数の開発者によって提供された複数のファイルがありますshapeType
。
PS:使用しています jsdoc3
enum
、定義にforを、関数パラメーターに和集合を表示しますShapeType|string
。ただし、列挙型は、Closure-compilerでの宣言後のサブタイプの追加をサポートしていません。