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

URLSearchParams.append() - パラメータを追加する

append()は、URLSearchParamsのメソッドです。クエリのパラメータを1つ追加します。

概要

名前
append
所属
URLSearchParams
IDL
void append(USVString name, USVString value);
仕様書
https://url.spec.whatwg.org/#dom-urlsearchparams-append

説明

第1引数(name)には、パラメータの名前を指定します。

第2引数(value)には、パラメータの値を指定します。

既にあるパラメータを指定しても、単純に追加されます。

デモ

URLSearchParams.append()のデモです。"toto"というパラメータを追加します。

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

<!DOCTYPE html>
<html>
<head>
<style>
body { word-break: break-all ; tab-size: 2 ; }
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<p><button id="append">追加 [append()]</button></p>
<hr>
<div id="result"></div>
<script>
var urlSearchParams = new URLSearchParams( "hoge=1&fuga=2&piyo=3" ) ;

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

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

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

document.getElementById( "append" ).onclick = function() {
	urlSearchParams.append( "toto", "4" ) ;
	getParamsInfo() ;
}

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

getParamsInfo() ;
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
49+ 29+ 10+×× 36+ 10.0+×
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月20日 (金)
コンテンツを公開しました。