SYNCERのロゴ
アイキャッチ画像

FormData.append() - データを追加する

append()は、FormDataのメソッドです。フォームにデータを追加します。

概要

名前
append
所属
FormData
IDL
void append(USVString name, USVString value);
void append(USVString name, Blob blobValue, optional USVString filename);
仕様書
https://xhr.spec.whatwg.org/#dom-formdata-append

説明

テキストデータを追加する場合は、第1引数(name)にキー名、第2引数(value)に値を指定します。

ファイルデータを追加する場合は、第1引数(name)にキー名、第2引数(blobValue)に値、第3引数(filename)に任意でファイル名を指定します。

同じキー名のデータが既に存在していても、重複して追加されます。

チュートリアル

下記のようなデータを追加するには、2つの引数を利用します。

<input name="hoge" value="fuga">
var formData = new FormData() ;
formData.append( "hoge", "fuga" ) ;

ファイルを追加するには、次のように、値にFile、またはBlobを指定して、第3引数にファイル名を指定しましょう。

var formData = new FormData() ;
formData.append( "hoge", blob, "image.png" ) ;

デモ

FormData.append()のデモです。ボタンをクリックするとデータを追加します。テキストのデータを追加する場合と、ファイルのデータを追加する場合を試してみて下さい。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<head>
<style>
body { word-break: break-all ; tab-size: 2 ; }
div#result { white-space: pre-wrap ; }
textarea#fuga { box-sizing: border-box ; width: 100% ; font-size: 16px ; }
</style>
</head>
<body>
<p><button id="append1">テキストデータを追加</button></p>
<p><button id="append2">ファイルを追加</button> (<a href="./image.png" target="_blank">画像</a>)</p>
<p><button id="reset">リセット</button></p>
<hr>
<p><button id="send">ajax通信で送信</button></p>
<hr>
<div id="result"></div>
<hr>
<textarea rows="15" id="fuga">ajax通信の結果</textarea>
<script>
var formData = new FormData() ;
var xhr = new XMLHttpRequest() ;
getFormDataInfo() ;

xhr.onloadend = function ( event ) {
	console.log( xhr ) ;
	document.getElementById( "fuga" ).value = xhr.response ;
}

document.getElementById( "append1" ).onclick = function () {
	formData.append( "name", "あらゆ" ) ;
	getFormDataInfo() ;
}

document.getElementById( "append2" ).onclick = function () {
	formData.append( "icon", blob, "image.png" ) ;
	getFormDataInfo() ;
}

document.getElementById( "reset" ).onclick = function () {
	formData = new FormData() ;
	getFormDataInfo() ;
}

document.getElementById( "send" ).onclick = function () {
	xhr.open( "POST", "https://syncer.ch/POST" ) ;
	xhr.send( formData ) ;
}

function getFormDataInfo () {
	document.getElementById( "result" ).textContent = "" ;

	console.log( formData ) ;
	appendText( formData + "\n" ) ;

	formData.forEach( function ( value, name ) {
		appendText( name + ": " + value + "\n" ) ;
	} ) ;
}

function appendText ( text ) {
	document.getElementById( "result" ).appendChild( document.createTextNode( text ) ) ;
}

var blob ;
var image = new Image() ;

image.onload = function() {
	var canvas = document.createElement( "canvas" ) ;
	var context = canvas.getContext( "2d" ) ;
	context.drawImage( image, 0, 0, 200, 150, 50, 50, 100, 75 ) ;
	canvas.toBlob( function( result ) {
		blob = result ;
	} ) ;
}

image.src = "./image.png" ;
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
5.1+ 10+ 12+ 4.0+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月24日 (火)
コンテンツを公開しました。