1 //{+xhr"XHR,XDR,MSXMLによる通信"(XMLHTTPRequest, XDomainRequest, ActiveX-MSXML を使った通信)[+net]
\r
3 // https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest
\r
4 // https://web.archive.org/web/20071101021832/http://web.paulownia.jp/script/ajax/xmlhttp4.html
\r
5 // https://web.archive.org/web/20091029170015/http://wiki.paulownia.jp/ajax/xmlhttprequest
\r
7 * http://ponpon-village.net/ajax/xmlhttp.htm
\r
8 * IE のバージョンによっては、ActiveXObject("Msxml2.XMLHTTP.5.0") , ActiveXObject("Msxml2.XMLHTTP.4.0") ,
\r
9 ActiveXObject("Msxml2.XMLHTTP.3.0") , ActiveXObject("Msxml2.XMLHTTP") なども使用出来る。
\r
11 http://vird2002.s8.xrea.com/javascript/XMLHttpRequest.html
\r
13 new ActiveXObject( 'Msxml2.XMLHTTP.3.0' ); // バージョン3.0 広範に利用されているので、今後も bugfix を行う
\r
14 new ActiveXObject( 'Msxml2.XMLHTTP.6.0' ); // バージョン6.0 は最新版なので bugfix を続ける
\r
16 // --- 使うべきではないオブジェクト
\r
17 new ActiveXObject( 'Microsoft.XMLHTTP' ); // Microsoft接頭辞は古いので指定すべきではない
\r
18 new ActiveXObject( 'Msxml.XMLHTTP' ); // Msxml2接頭辞を指定すべき
\r
19 new ActiveXObject( 'Msxml2.XMLHTTP' ); // バージョンを省略すると 3.0 として扱われるので、バージョンは明記すべき
\r
20 new ActiveXObject( 'Msxml2.XMLHTTP.4.0' ); // バージョン4.0 は bugfix が行われないので、3.0 か 6.0 を指定すべき
\r
21 new ActiveXObject( 'Msxml2.XMLHTTP.5.0' ); // バージョン5.0 は bugfix が行われないので、3.0 か 6.0 を指定すべき
\r
23 [IE][Javascript][Json] IE+Jsonではまった
\r
24 http://d.hatena.ne.jp/khiker/20081026/javascript_json
\r
25 > AddCharset utf-8 json
\r
26 > AddType text/javascript json
\r
28 JavaScriptでJSONをeval
\r
29 http://d.hatena.ne.jp/sshi/20060904/p1
\r
31 itozyun 2014-10-30 20:55:41
\r
32 basic 認証のかかったhtml を表示して、そのjsが xhr をすると Android1.6 では 401 error が返る。Android 2.3 では解決している。
\r
33 Android1.6- の XHR で 401 エラーが返った場合は、iframe に xml を表示させてその内容を取ればサーバ側の対応無しでいけるかも?
\r
34 Android2 にも xdomain な GET が一回しかできない問題 gears 使えない?
\r
36 IE9 で 画像バイナリの取得 VBA をかましている
\r
37 http://web.archive.org/web/20130808105151/http://gurimmer.lolipop.jp/daihakken/2012/05/22/javascriptajaxxmlhttprequest%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%9Fajax%E3%81%AE%E3%82%A8%E3%83%B3%E3%82%B3%E3%83%BC%E3%83%89
\r
38 http://d.hatena.ne.jp/maachang/20130221/1361427565
\r
40 http://web.archive.org/web/20130531162446/http://gurimmer.lolipop.jp/daihakken/2012/06/25/ajaxjavascript%E3%83%8D%E3%82%A4%E3%83%86%E3%82%A3%E3%83%96xmlhttp%E3%82%B5%E3%83%9D%E3%83%BC%E3%83%88%E3%81%A8%E3%81%AF/
\r
42 IE8 以下で xhr の失敗率が高い問題
\r
43 http://tkengo-totoro.blogspot.jp/2011/11/iexmlhttprequest.html
\r
44 TODO クライアント側にもリトライ機構を入れてみる
\r
47 var // Opera7.6+, Safari1.2+, khtml3.?+, Gecko0.9.7+
\r
48 // ie9- ではローカルリソースには MSXML を使う
\r
49 X_Net_XHR_createW3C = window[ 'XMLHttpRequest' ] && function(){ return X_Net_XHR_w3c || ( X_Net_XHR_w3c = new XMLHttpRequest() ); },
\r
50 X_Net_XHR_w3c = X_Net_XHR_createW3C && X_Net_XHR_createW3C(),
\r
51 X_Net_XHR_cors = X_Net_XHR_w3c && X_Net_XHR_w3c.withCredentials !== undefined,
\r
52 X_Net_XHR_progress = X_Net_XHR_w3c && X_Net_XHR_w3c.onprogress !== undefined,
\r
53 X_Net_XHR_upload = X_Net_XHR_w3c && !!X_Net_XHR_w3c.upload,
\r
55 X_Net_XHR_createXDR = window[ 'XDomainRequest' ] && function(){ return X_Net_XHR_xdr || ( X_Net_XHR_xdr = new XDomainRequest() ); },
\r
56 X_Net_XHR_xdr = X_Net_XHR_createXDR && X_Net_XHR_createXDR(),
\r
58 // ie11の互換モード(7,8)の msxml はいまいち動かない
\r
59 X_Net_XHR_createMSXML = X_UA[ 'ActiveX' ] && ( X_UA[ 'IE5x' ] || X_UA[ 'IE6' ] || X_URL_IS_LOCAL ) &&
\r
60 ( new Function( 'f', [
\r
61 'var x=".XMLHTTP",',
\r
63 'n=[m+".6.0",m+".3.0",m+".5.0",m+".4.0",m,"Microsoft"+x],',
\r
69 'return f?[v[++i],new a(n[i])]:new a(n[i])',
\r
74 X_Net_XHR_msXMLVer = 0,
\r
75 X_Net_XHR_msXML = X_Net_XHR_createMSXML && X_Net_XHR_createMSXML( true ),
\r
77 X_Net_XHR_neverReuse = X_UA[ 'IE' ] < 9 || X_UA[ 'iOS' ] || X_UA[ 'Android' ], // ie7,8 の xhr はリユース不可。msxml はリユース可能。
\r
79 X_Net_XHR_TYPE_FLASH = 8,
\r
80 X_Net_XHR_TYPE_GADGET = 16;
\r
82 if( X_Net_XHR_msXML ){
\r
83 X_Net_XHR_msXMLVer = X_Net_XHR_msXML[ 0 ];
\r
84 X_Net_XHR_msXML = X_Net_XHR_msXML[ 1 ];
\r
86 X_Net_XHR_createMSXML = null;
\r
91 'W3C' : X_Net_XHR_createW3C ? 1 : 0,
\r
92 'MSXML' : X_Net_XHR_createMSXML ? 2 : 0,
\r
93 'XDR' : X_Net_XHR_createXDR ? 4 : 0,
\r
96 * http://hakuhin.jp/as/import.html
\r
97 * ファイルの読み込みについて(4 or 5 or 6+)
\r
98 * http://hakuhin.jp/as/javascript.html
\r
99 * Flash から JavaScript にアクセスする(3+)
\r
101 'FLASH' : X_Pulgin_FLASH_ENABLED && 4 <= X_Pulgin_FLASH_VERSION ? 8 : 0,
\r
103 'GADGET' : 5.5 <= X_UA[ 'IE' ] || !X_UA[ 'IE' ] ? 16 : 0,
\r
106 * https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest
\r
107 * Progress Events Chrome7, firefox3.5, ie10, opera12, Safari?, Chrome for Android 0.16
\r
109 'PROGRESS' : X_Net_XHR_progress,
\r
111 'UPLOAD_PROGRESS' : X_Net_XHR_upload,
\r
113 // or gadget proxy or flash
\r
114 'CORS' : X_Net_XHR_xdr || X_Net_XHR_cors,
\r
116 'BINARY' : X_Pulgin_VBS_ENABLED
\r
119 if( X_Net_XHR_msXMLVer ) X[ 'XHR' ][ 'MSXML_VERSION' ] = X_Net_XHR_msXMLVer;
\r
121 if( X_Net_XHR_w3c || X_Net_XHR_msXML ){
\r
123 X_TEMP.X_Net_XHR_init = function(){
\r
124 X_NET_XHRWrapper = X_Class_override( X_EventDispatcher(), X_TEMP.X_Net_XHR_params, true );
\r
126 delete X_TEMP.X_Net_XHR_init;
\r
127 delete X_TEMP.X_Net_XHR_params;
\r
129 return X_NET_XHRWrapper;
\r
132 X_TEMP.X_Net_XHR_params = {
\r
134 '_rawType' : X_EventDispatcher_EVENT_TARGET_XHR,
\r
147 load : function( obj ){
\r
148 var raw = this[ '_rawObject' ],
\r
149 method = obj[ 'method' ],
\r
150 url = obj[ 'url' ],
\r
151 async = obj[ 'async' ] !== false,
\r
152 username = obj[ 'username' ],
\r
153 password = obj[ 'password' ],
\r
154 headers = obj[ 'headers' ] || {},
\r
155 postdata = obj[ 'postdata' ] || '',
\r
156 timeout = obj[ 'timeout' ] || 20000,
\r
157 noCache = obj[ 'cache' ] !== true,
\r
158 xDomain = !X_URL_isSameDomain( url ),
\r
159 isFile = X_URL_isLocal( url ),
\r
163 this._dataType = obj[ 'dataType' ];
\r
165 if( !raw || xDomain !== this._isXDR || ( X_Net_XHR_createMSXML && isFile !== this._isMsXML ) ){
\r
166 raw && this[ 'unlisten' ]( [ 'load', 'readystatechange', 'progress', 'error', 'timeout' ] );
\r
168 this[ '_rawObject' ] = raw = xDomain ?
\r
170 X_Net_XHR_createW3C() :
\r
171 X_Net_XHR_createXDR()
\r
174 ( X_Net_XHR_createMSXML ?
\r
175 ( X_Net_XHR_msXML = X_Net_XHR_msXML || X_Net_XHR_createMSXML() ):
\r
176 X_Net_XHR_createW3C()
\r
178 X_Net_XHR_createW3C ?
\r
179 X_Net_XHR_createW3C() :
\r
180 ( X_Net_XHR_msXML = X_Net_XHR_msXML || X_Net_XHR_createMSXML() );
\r
182 // raw === XDR これは error になるのでフラグに控える
\r
183 this._isXDR = X_Net_XHR_createXDR && xDomain;
\r
184 this._isMsXML = !X_Net_XHR_createW3C || ( isFile && X_Net_XHR_createMSXML );
\r
187 raw.open( method, url, async, username, password );
\r
189 if( raw.responseType !== undefined ){
\r
190 switch( this._dataType ){
\r
194 raw.responseType = 'text';
\r
196 case 'json' : // firefox9- は moz-json
\r
197 raw.responseType = X_UA[ 'Gecko' ] < 10 ? 'moz-json' : X_UA[ 'Gecko' ] ? this._dataType : ''; // Iron 37 でエラー
\r
204 raw.responseType = 'document';
\r
207 case 'arraybuffer' :
\r
208 // jpeg,jpg,png,gif,mp3,ogg...
\r
209 raw.responseType = this._dataType;
\r
214 // http://www.quirksmode.org/blog/archives/2005/09/xmlhttp_notes_r_1.html
\r
215 if( !this._isMsXML && raw.overrideMimeType ){
\r
216 switch( X_URL_getEXT( url ) || this._dataType ){
\r
223 tmp = 'application/json'; // 2015.6.29
\r
227 tmp = 'audio/mpeg';
\r
240 tmp = 'audio/x-m4a"';
\r
243 tmp = 'audio/x-mp4';
\r
246 tmp = 'audio/webm';
\r
249 if( tmp = obj[ 'mimeType' ] || tmp ) raw.overrideMimeType( tmp );
\r
252 if( !this._isXDR && ( this._isMsXML ? 3 <= X_Net_XHR_msXMLVer : raw.setRequestHeader ) ){ // msxml は setRequestHeader getter がいけない
\r
256 headers[ 'Pragma' ] = 'no-cache';
\r
257 headers[ 'Cache-Control' ] = 'no-cache';
\r
258 headers[ 'If-Modified-Since' ] = 'Thu, 01 Jun 1970 00:00:00 GMT';
\r
261 // http://nakigao.sitemix.jp/blog/?p=2040
\r
262 // json 取得時に SafariでHTTP/412のエラー。但し相手が audio の場合この指定があるとロードに失敗する。 iOS8.2, iOS7.1 では遭遇せず
\r
263 if( this._dataType === 'json' ){
\r
264 headers[ 'If-Modified-Since' ] = ( new Date ).toUTCString();
\r
267 // http://boscono.hatenablog.com/entry/2013/12/23/152851
\r
268 if ( !xDomain && !headers[ 'X-Requested-With' ] ) {
\r
269 headers[ 'X-Requested-With' ] = 'XMLHttpRequest';
\r
272 if( method === 'POST' && !headers[ 'Content-Type' ] ){
\r
273 headers[ 'Content-Type' ] = 'application/x-www-form-urlencoded';
\r
277 for( p in headers ){
\r
278 if( X_EMPTY_OBJECT[ p ] ) continue;
\r
279 //console.log( headers[ p ] );
\r
280 headers[ p ] !== undefined && raw.setRequestHeader( p, headers[ p ] + '' ); // Opera8.01+, MSXML3+
\r
284 if( !this._isMsXML && raw.timeout !== undefined ){
\r
285 raw.timeout = timeout;
\r
287 this._timerID = X_Timer_once( timeout, this, this.onTimeout );
\r
290 // send 前にフラグを立てる,回線が早いと raw.send() 内で onload -> _busy = false ののち、 _busy = true するため。
\r
293 raw.send( X_Type_isString( postdata ) ? postdata : X_String_serialize( postdata ) );
\r
295 if( !async || raw.readyState === 4 ){
\r
296 X_Timer_once( 32, this, this.handleEvent, [ { type : 'readystatechange' } ] );
\r
299 if( this._isMsXML ){
\r
300 raw[ 'onreadystatechange' ] = X_NET_XHRWrapper.handleEvent;
\r
302 if( X_Net_XHR_progress || this._isXDR ){
\r
303 this[ 'listen' ]( [ 'load', 'progress', 'error', 'timeout' ] ); //, 'abort'
\r
305 if( X_UA[ 'IE8' ] ){
\r
306 this[ 'listen' ]( [ 'readystatechange', 'error', 'timeout' ] );
\r
308 if( X_UA[ 'IE7' ] ){
\r
309 this[ 'listen' ]( [ 'readystatechange', 'error' ] );
\r
312 this[ 'listen' ]( [ 'load', 'readystatechange', 'error', 'timeout' ] ); //, 'abort'
\r
315 if( X_Net_XHR_upload ){
\r
316 raw.upload.addEventListener( 'progress', this.onUploadProgress );
\r
321 cancel : function(){
\r
322 /* this[ '_rawObject' ].abort && */ this[ '_rawObject' ].abort();
\r
323 this._canceled = true;
\r
326 reset : function(){
\r
328 this._method = this._dataType = '';
\r
329 this._canceled = this._busy = this._error = false;
\r
330 this._timerID && X_Timer_remove( this._timerID );
\r
331 this._percent = this._timerID = 0;
\r
333 // XMLHttpRequest の使い方
\r
334 // http://webos-goodies.jp/archives/50548720.html
\r
335 // XMLHttpRequest オブジェクトを再利用する際も、 abort メソッドを呼び出す必要があるようです。
\r
336 /* this[ '_rawObject' ].abort && */ this[ '_rawObject' ].abort();
\r
338 // XMLHttpRequest で順番にリソースを取得する
\r
339 // http://note.chiebukuro.yahoo.co.jp/detail/n16248
\r
340 // Opera 10.10 と Safari 4.1 はエラーが起きた XHR を再利用できないので毎回作る
\r
343 // domes.lingua.heliohost.org/dom-intro/load-save2.html
\r
344 // 規定上は open() を呼び出すと XMLHttpRequest オブジェクトが未送信状態に戻りますが、
\r
345 // Opera 10.10、Safari 4.1 では、同一オリジン制限に違反した XMLHttpRequest オブジェクトは再度 open() しても未送信状態に戻りません。
\r
347 // Timeout した Gecko の xhr.response に触るとエラー??
\r
349 if( this._error || ( X_Net_XHR_neverReuse && !this._isMsXML ) ){
\r
351 if( X_Net_XHR_upload ){
\r
352 X_Net_XHR_w3c.upload.removeEventListener( 'progress', this.onUploadProgress );
\r
355 // ie7 は xhr object を再利用できない。但し send のあとに alert を挟むと動いた、、、
\r
356 // ie7モード(IE11) では再利用可能、、、
\r
358 X_EventDispatcher_toggleAllEvents( this, false );
\r
359 this[ '_rawObject' ] = null;
\r
362 X_Net_XHR_xdr = null;
\r
363 delete this._isXDR;
\r
365 X_Net_XHR_w3c = null;
\r
368 this[ 'unlisten' ]( [ 'load', 'readystatechange', 'progress', 'error', 'timeout' ] );
\r
372 handleEvent : function( e ){
\r
373 var raw = X_NET_XHRWrapper[ '_rawObject' ],
\r
374 live = !X_NET_XHRWrapper._canceled,
\r
375 headers, status, data;
\r
377 switch( e && e.type || 'readystatechange' ){
\r
379 * http://memopad.bitter.jp/w3c/ajax/ajax_xmlhttprequest_onreadystatechange.html
\r
380 readyState XMLHttpRequest のステータスを保持する。0 から 4 までに変化する:
\r
385 4: リクエストは終了してレスポンスの準備が完了
\r
387 404: Page not found
\r
389 If-Modified-Sinceヘッダを利用してWebページのキャッシュを行うXMLHttpRequestラッパー
\r
390 http://www.semblog.org/msano/archives/000407.html
\r
392 case 'readystatechange' :
\r
393 //if( !X.XHR.PROGRESS ){
\r
394 switch( raw.readyState ){
\r
398 case 2 : // 0% ajaxstart
\r
399 live && X_NET_XHRWrapper[ 'asyncDispatch' ]( { type : X_EVENT_PROGRESS, 'percent' : 0 } );
\r
402 live && X_NET_XHRWrapper[ 'asyncDispatch' ]( { type : X_EVENT_PROGRESS, 'percent' : X_NET_XHRWrapper._percent < 99.9 ? 99.9 : ( X_NET_XHRWrapper._percent + 100 ) / 2 } );
\r
406 if( X_NET_XHRWrapper._percent === 100 ) return; // Opera8 readystatechange が2重に発生
\r
417 if( !X_NET_XHRWrapper._busy ) return;
\r
419 X_NET_XHRWrapper._percent = 100;
\r
420 X_NET_XHRWrapper._busy = false;
\r
421 status = raw.status;
\r
423 // TODO GET_FULL_HEADERS
\r
424 // https://msdn.microsoft.com/en-us/library/ms766595%28v=vs.85%29.aspx
\r
425 // Implemented in: MSXML 3.0 and MSXML 6.0
\r
426 if( X_NET_XHRWrapper._isXDR ){
\r
427 headers = { 'Content-Type' : raw.contentType };
\r
429 if( ( X_NET_XHRWrapper._isMsXML ? 3 <= X_Net_XHR_msXMLVer : raw.setRequestHeader ) && ( headers = raw.getAllResponseHeaders() ) ){
\r
430 headers = X_NET_XHR_parseResponseHeaders( headers );
\r
433 // https://code.google.com/p/fakeworker-js/source/browse/src/javascript/fakeworker.js
\r
435 ( !status && location.protocol === 'file:' ) ||
\r
436 // IE 6.0 でローカルファイルにアクセスした
\r
437 ( status < 100 && ( status = 200 ) ) ||
\r
438 ( 200 <= status && status < 400 ) ||
\r
439 //status === 304 ||
\r
440 ( status === 1223 && ( status = 204 ) ) ||
\r
441 ( X_UA[ 'Webkit' ] && status === undefined ) // safari: /webkit/.test(userAgent)
\r
444 * opera8, safari2, khtml3 で utf8 日本語文字列の文字化け
\r
447 // parse json, html, xml, text, script, css
\r
448 switch( X_NET_XHRWrapper._dataType ){
\r
451 data = raw[ 'responseText' ];
\r
455 data = raw[ 'response' ] || raw[ 'responseText' ];
\r
456 // eval() を使っているけど JSON の無いブラウザは XDomain な XHR はできないのでよしとする。
\r
457 // XDomain な XHR の際は Flash 等で代替し、その中に Json parser も組み込む。
\r
458 // http://d.hatena.ne.jp/sshi/20060904/p1
\r
459 if( !X_Type_isObject( data ) ) data = X_JSON_parseTrustableString( data );
\r
465 // svg, vml, xaml, xul, mxml ??
\r
466 data = raw[ 'responseXML' ] || raw[ 'response' ] || raw[ 'responseText' ]; // とりあえず
\r
469 case 'arraybuffer' :
\r
470 data = raw[ 'response' ] || raw[ 'responseText' ]; // とりあえず
\r
473 X_NET_XHRWrapper[ 'asyncDispatch' ]( 32, { type : X_EVENT_SUCCESS, status : status || 200, response : data, 'headers' : headers || null } );
\r
475 X_NET_XHRWrapper[ 'asyncDispatch' ]( 32, { type : X_EVENT_ERROR, status : status || 400, 'headers' : headers || null } );
\r
480 if( e.lengthComputable ){
\r
481 X_NET_XHRWrapper._percent = e.loaded / e.total * 100;
\r
482 live && X_NET_XHRWrapper._percent < 100 && X_NET_XHRWrapper[ 'asyncDispatch' ]( { type : X_EVENT_PROGRESS, 'percent' : X_NET_XHRWrapper._percent } );
\r
487 //console.dir( e );
\r
488 X_NET_XHRWrapper._busy = false;
\r
489 X_NET_XHRWrapper._error = X_UA[ 'Opera' ] || X_UA[ 'Webkit' ] ;
\r
490 live && X_NET_XHRWrapper[ 'asyncDispatch' ]( 32, { type : X_EVENT_ERROR, status : raw.status } );
\r
493 case 'timeout' : // Gecko 12.0 https://developer.mozilla.org/ja/docs/XMLHttpRequest/Synchronous_and_Asynchronous_Requests
\r
494 X_NET_XHRWrapper._busy = false;
\r
495 X_NET_XHRWrapper._error = !!X_UA[ 'Gecko' ];
\r
496 X_NET_XHRWrapper[ 'asyncDispatch' ]( { type :X_EVENT_ERROR, 'timeout' : true, status : 408 } );
\r
501 onTimeout : function(){
\r
502 var raw = this[ '_rawObject' ],
\r
503 live = !X_NET_XHRWrapper._canceled || !this._busy;
\r
505 if( live || raw.readyState < 3 ){
\r
506 this._busy = false;
\r
507 live && this[ 'asyncDispatch' ]( { type : X_EVENT_ERROR, 'timeout' : true, status : 408 } );
\r
512 onUploadProgress : X_Net_XHR_upload && function( e ){
\r
513 !X_NET_XHRWrapper._canceled &&
\r
514 X_NET_XHRWrapper[ 'asyncDispatch' ]( {
\r
515 type : X_EVENT_PROGRESS,
\r
516 'percent' : X_NET_XHRWrapper._percent,
\r
517 'uploadPercent' : e.loaded / e.total * 100
\r
521 // 同期リクエストでなければならない場合, unload, beforeunload時
\r
525 * https://gist.github.com/mmazer/5404301
\r
527 * XmlHttpRequest's getAllResponseHeaders() method returns a string of response
\r
528 * headers according to the format described here:
\r
529 * http://www.w3.org/TR/XMLHttpRequest/#the-getallresponseheaders-method
\r
530 * This method parses that string into a user-friendly key/value pair object.
\r
532 * http://hakuhin.jp/js/xmlhttprequest.html#XHR_GET_ALL_RESPONSE_HEADERS
\r
533 * 複数の情報が存在する場合、改行で区切られています。
\r
536 function X_NET_XHR_parseResponseHeaders( headerStr ){
\r
537 var headers = {}, headerPairs, i = 0, l, headerPair, index, key, val;
\r
539 if( !headerStr ) return headers;
\r
541 headerPairs = headerStr.split( '\u000d\u000a' );
\r
542 for( l = headerPairs.length; i < l ; ++i ){
\r
543 headerPair = headerPairs[i];
\r
544 index = headerPair.indexOf( '\u003a\u0020' );
\r
546 key = headerPair.substring( 0, index );
\r
547 val = headerPair.substring( index + 2 );
\r
548 headers[ key ] = val.split( '\r\n' ).join( '\n' ).split( '\n' );
\r