<returns> (JavaScript)

Visual Studio 2017 RC の最新のドキュメントの詳細については、Visual Studio 2017 RC ドキュメントをご参照ください。

関数またはメソッドの呼び出しの結果のドキュメント情報を指定します。

構文

<returns type="ValueType" integer="true|false"  
    domElement="true|false" mayBeNull="true|false"  
    elementType="ArrayElementType" elementInteger="true|false"  
    elementDomElement="true|false" elementMayBeNull="true|false"  
    locid="descriptionID" value="code">description  
</returns>  

パラメーター

type
省略可能。 戻り値のデータ型。 型は以下のいずれかです。

  • NumberObject など、ECMAScript 5 仕様に含まれる ECMAScript 言語の型。

  • HTMLElementWindowDocument などの DOM オブジェクト。

  • JavaScript のコンストラクター関数。

    integer
    省略可能。 typeNumber である場合に、戻り値が整数かどうかを指定します。 戻り値が整数であることを示す場合は true に設定します。それ以外の場合は false に設定します。 Visual Studio では、この属性は IntelliSense 情報を提供するためには使用されません。

    domElement
    省略可能。 この属性は廃止されました。この属性より type 属性が優先されます。 この属性は、ドキュメント化された戻り値が DOM 要素であるかどうかを指定します。 戻り値が DOM 要素であることを指定する場合は true に設定します。それ以外の場合は false に設定します。 type 属性が設定されておらず domElementtrue に設定されている場合、IntelliSense の入力候補機能では、ドキュメント化された戻り値が HTMLElement として処理されます。

    mayBeNull
    省略可能。 ドキュメント化された戻り値を null に設定できるかどうかを指定します。 戻り値を null に設定できることを示す場合は true に設定します。それ以外の場合は false に設定します。 既定値は false です。 Visual Studio では、この属性は IntelliSense 情報を提供するためには使用されません。

    elementType
    省略可能。 typeArray であれば、この属性は、配列内の要素の型を指定します。

    elementInteger
    省略可能。 typeArray であり、elementTypeNumber である場合、この属性は、配列内の要素が整数であるかどうかを指定します。 配列内の要素が整数であることを示す場合は true に設定します。それ以外の場合は false に設定します。 Visual Studio では、この属性は IntelliSense 情報を提供するためには使用されません。

    elementDomElement
    省略可能。 この属性は廃止されました。この属性より elementType 属性が優先されます。 typeArray である場合、この属性は、配列内の要素が DOM 要素であるかどうかを指定します。 要素が DOM 要素であることを指定する場合は true に設定します。それ以外の場合は false に設定します。 elementType 属性が設定されておらず elementDomElementtrue に設定されている場合、IntelliSense の入力候補機能では、配列内の各要素が HTMLElement として処理されます。

    elementMayBeNull
    省略可能。 typeArray である場合、配列内の要素を null に設定できるかどうかを指定します。 配列内の要素を null に設定できることを示す場合は true に設定します。それ以外の場合は false に設定します。 既定値は false です。 Visual Studio では、この属性は IntelliSense 情報を提供するためには使用されません。

    locid
    省略可能。 戻り値に関するローカライズ情報用の識別子。 この識別子は、メンバーの ID であるか、または OpenAjax のメタデータで定義されているメッセージ バンドル内の name 属性値に対応します。 この識別子の型は、<loc> タグで指定された形式によって異なります。

    value
    省略可能。 関数コード自体ではなく、IntelliSense による使用のための評価が必要なコードを指定します。 たとえば、この属性を使用して、Promise などの非同期コールバックに IntelliSense を提供できます。 <returns> 要素で value 属性を使用すると、長いコードの実行をバイパスすることで IntelliSense のパフォーマンスを改善できます。

    description
    省略可能。 戻り値の説明。

解説

<returns> 要素は、ステートメントの前の関数本体に配置する必要があります。

使用例

<returns> 要素を使用する方法を次のコード例に示します。

function areaFunction(radiusParam)  
{  
    /// <summary>Determines the area of a circle when provided a radius parameter.</summary>  
    /// <param name="radiusParam" type="Number">The radius of the circle.</param>  
    /// <returns type="Number">The area.</returns>  
    var areaVal;  
    areaVal = Math.PI * radiusParam * radiusParam;  
    return areaVal;  
}  

// The following examples use the <remarks> element with a value attribute.  

function getJson(complete) {   
    /// <returns value='complete("")' ></returns>  
    var r = new XMLHttpRequest();   
    // . . .   
}   

getJson(function (json) {   
    json.  // IntelliSense for a String object is   
           // available here.  
});  

function calculate(x) {  
    /// <returns value='1'/>  
}  
calculate().  // Completion list for a Number.  

参照

XML ドキュメント コメント