上級

キーワード引数を委譲するメソッドで ** を付け忘れると ArgumentError になる

受け取ったキーワード引数（**optionsで受けたハッシュ）をそのまま別のメソッドに渡すには、呼び出し側でも**を付けて展開する必要があります。**を付けずに渡すと、ハッシュが1個の位置引数として渡ってしまい、キーワード引数として認識されずArgumentErrorになります。

エラーメッセージの読み方

main.rb:1:in `configure': wrong number of arguments (given 1, expected 0; required keywords: host, port) (ArgumentError)

main.rb

ファイル名

1

行番号 — 実際にクラッシュした行

configure

発生場所 — <main> ならトップレベル、メソッド名ならそのメソッドの中

ArgumentError

例外クラス — 何が起きたか。ここを検索するのが最短です

wrong number of arguments (given 1, expected 0; required keywords: host, port)

詳細メッセージ — どの値が問題だったか

このエラーが出る典型パターン

 1  def configure(host:, port:)
 2    "#{host}:#{port}"
 3  end
 4  
 5  def wrapper(**opts)
 6    configure(opts)  
                   ^
 7  end
 8  
 9  puts wrapper(host: "localhost", port: 3000)

 1  def connect(host:, timeout:)
 2    "#{host} (#{timeout}s)"
 3  end
 4  
 5  def wrapper(**opts)
 6    connect(opts)  
                 ^
 7  end
 8  
 9  puts wrapper(host: "db", timeout: 5)

 1  def setup(mode:, level:)
 2    "#{mode}/#{level}"
 3  end
 4  
 5  def wrapper(**opts)
 6    setup(opts)  
               ^
 7  end
 8  
 9  puts wrapper(mode: "auto", level: 3)

 1  def build_url(scheme:, path:)
 2    "#{scheme}://#{path}"
 3  end
 4  
 5  def wrapper(**opts)
 6    build_url(opts)  
                   ^
 7  end
 8  
 9  puts wrapper(scheme: "https", path: "example.com")

 1  def register(name:, plan:)
 2    "#{name}/#{plan}"
 3  end
 4  
 5  def wrapper(**opts)
 6    register(opts)  
                  ^
 7  end
 8  
 9  puts wrapper(name: "taro", plan: "pro")

よくある誤解

「**optionsで受け取った値は、そのまま書けばキーワード引数として次のメソッドに伝わるはず」という思い込みは誤りです。**を付けずに渡すとただのハッシュという位置引数1個として扱われるため、受け取り側がキーワード引数を期待しているとエラーになります。

まとめ

キーワード引数を委譲するメソッドで ** を付け忘れると ArgumentError になるは上級でつまずきやすい項目です。上の5パターンを実際に手で直すと、エラーメッセージのどこを読めばよいかが掴めます。

演習をはじめる

関連するエラー

• 可変長引数を委譲するメソッドで * を付け忘れると ArgumentError になる受け取った可変長引数（*argsで受けた配列）をそのまま別のメソッドに渡すには、呼び出し側でも*を付けて展開する必要があります。
• 必須キーワード引数を渡し忘れると ArgumentError になるデフォルト値の無いキーワード引数（name: のようにコロンだけで値を書かない形）は必須です。