「利用者:Sukemaru」を編集中 (節単位)

== 組み込み用コード・小関数 ==
メインコードの途中に短い [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Statements/function 関数] を置く場合は、最初の呼び出しコードより前に変数（[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/function 関数式]）として定義しておいてもよい。
<syntaxhighlight lang="javascript">
{
  var hoge = "hogehoge";
  // function 宣言で定義された関数は、宣言された位置より前からでも呼び出せる
  document.selection.Text = HogeFuga( hoge );

  // 関数宣言は参照可能なスコープ内のどの位置に置いてもよい
  function HogeFuga( str ) {
    return str.replace( /hoge/ig, "fuga" );
  }
}
</syntaxhighlight>
ならば、以下のような記述でも同じ意味 （ただし、関数式の場合は、最初に呼び出す文よりも前に定義しておくこと）。
<syntaxhighlight lang="javascript">
// 関数式は最初に呼び出されるよりも前に定義すること
var HogeFuga = function( str ) {
  return str.replace( /hoge/ig, "fuga" );
};
var hoge = "hogehoge";

document.selection.Text = HogeFuga( hoge );
</syntaxhighlight>

=== メタ記号をエスケープする ===
任意の文字列を正規表現変数 <syntaxhighlight lang="javascript" inline>RegExp()</syntaxhighlight> におさめる前などにエスケープ（退避修飾）する。

* '''正規表現のメタ記号のみ''' をエスケープする方法。
: ※ ref. 『[https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Regular_Expressions#Escaping 正規表現 - JavaScript | MDN]』

<syntaxhighlight lang="javascript">
/**
 * 関数 RegQuote( str )
 * 
 * 正規表現のメタ記号をすべてエスケープ（退避修飾）する
 */

function RegQuote( str ) {
  return str.replace( /[.*+?^=!:${}()|[\]\/\\]/g, "\\$&" ); 
}
</syntaxhighlight>

* または、記述の簡単な方法（ただし、<q>処理対象の文字列が長大</q> な場合や <q>日本語テキスト</q> の場合には適さない）。
: ※ ref. 『[https://ja.wikibooks.org/wiki/JavaScript/%E6%AD%A3%E8%A6%8F%E8%A1%A8%E7%8F%BE#RegExp JavaScript/正規表現 - Wikibooks]』

<syntaxhighlight lang="javascript">
/**
 * 関数 Quote( str )
 * 
 * 半角アルファベットと半角数字以外の文字を
 * すべてエスケープして返す
 */

function Quote( str ) {
  return str.replace( /\W/g, "\\$&" );
}

// Wikibooks 版は関数を無駄にネストしている…
// function Quote( str ) {
//   return str.replace( /\W/g, function( $0 ) {
//     return "\\" + $0;
//   } );
// }
</syntaxhighlight>
: ※ JavaScript において <b style="color:#c00;"> $& </b> は "マッチした部分文字列全体" を意味する JavaScript ネイティブの [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/replace#Specifying_a_string_as_a_parameter 特殊変数]。
:: 置換関数 function() の引数がひとつの場合、その引数は <b style="color:#c00;"> $& </b> と同じ意味になるので、上の関数で '''$0''' と記述していることに特別な意味はない（'''tmp''' や '''str'''、'''chr''' など任意の文字列でもよい）。
: ※ 後述、[[#関数の「呼び出しコスト」|関数の「呼び出しコスト」]] の項に書いているように、上出のふたつの <syntaxhighlight lang="javascript" inline>Quote( str )</syntaxhighlight> 関数の処理速度にはちがいが生じる。

=== 数値を３ケタ区切り（カンマ区切り）にする ===
<syntaxhighlight lang="javascript">
/**
 * 関数 SeparateNum( num )
 * 
 * 数値を３ケタごとにカンマ区切りした文字列にして返す
 * 引数（推奨）：整数値
 * ※ 小数点以下が４ケタ以上の場合、小数点以下もケタ区切りされてしまう
 */

function SeparateNum( num ) {
  return num.toString().replace( /(\d)(?=(?:\d{3})+(?!\d))/g, "$1," );
}
</syntaxhighlight>

小数、または半角数字を含む文字列の場合は
<syntaxhighlight lang="javascript">
/**
 * 関数 SeparateNum2( num )
 * 
 * 数値を３ケタごとにカンマ区切りした文字列にして返す
 * 引数：任意の数値（を含む文字列）
 * ※ 小数点以下はケタ区切りしない
 */

function SeparateNum2( num ) {
  var num = ( num === 0 || ! num ) ? "0" : num;
  var a = num.toString().split( /\b/ );
  for ( var i = 0, len = a.length; i < len; i ++ ) {
    if ( a[i] == "." ) { i ++; continue; }
    a[i] = a[i].replace( /(\d)(?=(?:\d{3})+(?!\d))/g, "$1," );
  }
  return a.join( "" );
}
</syntaxhighlight>

=== 数値を小数点以下３ケタの固定長にする ===
<syntaxhighlight lang="javascript">
/**
 * 関数 NumFix( num )
 * 
 * 数値を小数点以下３ケタの固定長小数（文字列）にして返す
 * 引数（推奨）：任意の数値（または数字のみの文字列）
 */

function NumFix( num ) {
  if ( typeof num == "number" ) {
    return num.toFixed( 3 );
  }
  else if ( /^-?\d+(?:\.\d+)?$/.test( num.toString() ) ) {
    return Number( num ).toFixed( 3 );
  }
  else {
    return num;
  }
}

// 対象が数値（ Number 型）であれば toFixed() だけでよい
// num = num.toFixed( 3 );
</syntaxhighlight>

=== 数値をケタ埋め（ゼロ埋め）する ===
※ 引数の型に応じた関数を使用する。

<syntaxhighlight lang="javascript">
/**
 * 関数 Pad( num )
 * 
 * 半角１ケタの数値を０埋めして２ケタの文字列で返す
 * ※ 引数は「正の整数値」のみ
 */

function Pad( num ) {
  return num < 10 ? "0" + num : num;
}
</syntaxhighlight>
<syntaxhighlight lang="javascript">
/**
 * 関数 Pad2( str )
 * 
 * 文字列中に含まれる半角１ケタの数値を０埋めして２ケタにした文字列で返す
 * ※ 引数は「文字列値」のみ
 */

function Pad2( str ) {
  return str.replace( /[0-9]+/g , function( num ) {
    return num.length < 2 ? "0" + num : num
  } );
}
</syntaxhighlight>
<syntaxhighlight lang="javascript">
/**
 * 関数 NumPad2( val )
 * 
 * 半角１ケタの数字を０埋めして２ケタにした文字列で返す
 */

function NumPad2( val ) {
  return val.toString().replace( /[0-9]+/g, function( num ) {
    return num.length < 2 ? "0" + num : num;
  } );
}
</syntaxhighlight>

=== 任意の文字列のくりかえしで埋める ===
※ Windows XP 用
<syntaxhighlight lang="javascript">
/**
 * 関数 Repeat( str, count )
 * 
 * String.prototype.repeat( count ) の代用
 */

function Repeat( str, count ) {
  var ret = "";
  for ( var i = 0; i < count; i ++ ) {
    ret += str;
  }
  return ret;
}
</syntaxhighlight>

=== ascii 文字に対応する全角英数記号を半角変換 ／ 数値専用の入力ダイアログ ===
※ IME: ON の状態で入力された「全角数字」も許容、「全角/半角の数字」以外の文字列は無視する入力ダイアログのサンプルコード
<syntaxhighlight lang="javascript">
/**
 * 関数 ToHalfWidth( str )
 * 
 *  ascii 文字に対応する全角英数記号の文字列を半角変換した ascii 文字列で返す
 * ※ カタカナや ascii 文字に対応しない文字列部分はそのまま残す
 * ※ 引数は「文字列値」のみ
 */
function ToHalfWidth( str ) {
  return str.replace( /[！-～]/g, function( tmp ) {
      return String.fromCharCode( tmp.charCodeAt(0) - 0xFEE0 )
} ) };

/**
 * Number( ToHalfWidth( Prompt( message,"" ) ).replace( /\D/g, "" ) )
 * 
 * 正の整数値専用の入力ダイアログ
 * ※ ダイアログに入力された "全角/半角の数字" 部分のみを "正の整数値" として取得する
 *    i.e. 入力値が「1あ２」「-12」「1.2」「０１２Ａ」ならば 12 とみなす
 */
var p = Number(
  ToHalfWidth( Prompt( "数値を入力", "" ) )
  .replace( /\D/g, "" )		// 置換処理で半角数字以外を削除
);

// e.g. 入力された値がゼロや無効な文字列のみなら「キャンセル」
if ( ! p ) { Status = "キャンセル"; }
else       { Alert( p ); }
</syntaxhighlight>

=== ストップウォッチ・タイマー ===
<syntaxhighlight lang="javascript">
// 計測開始		※ ソースコードの先頭付近におくこと
var start = new Date();

// 任意のコードを実行
{ ; }

// ステータスバーに処理時間を表示
Status = ( ( new Date() - start ) / 1000 ).toFixed( 3 ) + " 秒";
</syntaxhighlight>

=== Mery のバージョン情報 ===
<syntaxhighlight lang="javascript">
/**
 * Mery のバージョン情報
 */
var meryVersion = /([^\\]+$)/.exec( editor.FullName )[1] + " "
                + editor.Version;
Status = meryVersion;
</syntaxhighlight>

=== JavaScript (JScript) エンジンのバージョン情報 ===
※ ref. 『[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc392005%28v=msdn.10%29 ScriptEngine 関数 (JScript) | Microsoft Docs]』

<syntaxhighlight lang="javascript">
/**
 * JavaScript (JScript) エンジンのバージョン情報
 */
var engine = ScriptEngine() + " ";
           + ScriptEngineMajorVersion() + ".";
           + ScriptEngineMinorVersion() + ".";
           + ScriptEngineBuildVersion();
Status = engine;
</syntaxhighlight>