こんにちは！FlutterやDartの開発現場で、日夜コードと向き合っている先輩エンジニアです。
皆さんは、オブジェクト指向のプログラムを書いていて「あー、このクラスの中身を取り出すために、わざわざgetterをいくつも呼び出すの、ちょっと面倒だな…」と感じたことはありませんか？あるいは、状態をパパッと取り出して分岐したいだけなのに、コードが冗長になってしまってモヤモヤした経験はありませんか？
Dart 3で導入された「オブジェクトパターン（Object Patterns）」を使いこなせるようになると、そんなモヤモヤが嘘のようにスッキリ解消しますよ。
ここをクリアすれば、あなたのDartコードは一気にモダンで洗練されたものになります。一緒に基本から本質までマスターしていきましょう！
—
1. そもそも「オブジェクトパターン」って何？
これまでのDartでは、オブジェクトのプロパティ（メンバ変数）にアクセスするには、必ず `instance.property` のようにドット演算子を使って地道に値を取り出す必要がありましたよね。
// 従来の書き方
String getRoleDescription(User user) {
if (user.role == ‘admin’ && user.isActive) {
return ‘管理者（有効）’;
}
return ‘一般ユーザー’;
}
これでも動きますが、もし確認したいプロパティが増えたり、ネストしたオブジェクトから値をごっそり取り出したりしようとすると、コードの見通しがどんどん悪くなっていきます。
そこで登場するのが、Dart 3のオブジェクトパターンです。
これは、「オブジェクトの構造をそのままパターン（型とプロパティの形）として表現し、マッチさせながら中の値を直接変数にブチ抜いて取り出す」という強力な仕組みです。
形象的なイメージ
オブジェクトパターンは、いわば「型つきの型抜きクッキー」のようなものです。
特定の形（クラス名とプロパティ）にピタッとハマるかどうかをコンパイル時に検証し、ハマれば中の美味しい部分（値）を一瞬でくり抜いて手元に持ってきてくれます。
—
2. 基本的な使い方：`switch` や `if-case` で使ってみよう
百聞は一見にしかず。実際のコードを見てみましょう。
ここでは、ユーザー情報を表す `User` クラスを例にします。
class User {
final String name;
final int age;
final bool isAdmin;
const User(this.name, this.age, this.isAdmin);
}
この `User` インスタンスに対して、オブジェクトパターンを使って条件分岐と値の抽出を同時に行うコードがこちらです。
void evaluateUser(User user) {
// if-case文によるオブジェクトパターン
if (user case User(name: var n, isAdmin: true)) {
print(‘管理者ユーザーを発見しました: $nさん’);
} else {
print(‘一般のユーザーです。’);
}
}
コードのここがポイント！
- `user case User(name: var n, isAdmin: true)` の部分がオブジェクトパターンです。
- 「`user` が `User` クラスのインスタンスであり、かつ `isAdmin` が `true` である」という条件に一致（マッチ）するかを判定しています。
- さらに、マッチした瞬間に `name` プロパティの値を `var n` というローカル変数に直接バインド（抽出）しています。わざわざ `user.name` と書く必要がなくなっているのが分かりますよね。
—
3. さらにスマートに！「名前の省略（Variable Patterns）」
先ほどのコードで、`name: var n` と書きました。実はDartには、プロパティ名と受け取る変数名を同じにしたい場合、もっと短く書けるショートハンドが用意されています。
変数を `var` や `final` をつけてそのままプロパティ名として書くだけです。
void evaluateUserSmart(User user) {
switch (user) {
// nameプロパティをそのまま同名の変数 ‘name’ として取り出す
case User(name: final name, age: final age, isAdmin: true):
print(‘$nameさん ($age歳) は管理者です。’);
break;
case User(name: final name, isAdmin: false):
print(‘$nameさんは一般ユーザーです。’);
break;
}
}
どうですか？ ドットアクセスを何度も書く必要がなくなり、まるでデータの構造をそのまま視覚的に捉えるような、非常にクリーンなコードになりましたよね。
—
4. 陥りやすい文法エラーと注意ポイント
新しい機能を学ぶとき、誰もが一度はハマる罠があります。現場でよくあるつまずきポイントを先回りして解説しておきますね。
① `case` キーワードの付け忘れ
パターンマッチングを行う際は、`if (x case …)` や `switch (x) { case … }` のように、必ず `case`（または Dart 3.0以降なら `switchスプレッド`など）を明示する必要があります。
// ❌ やってしまいがちなエラー
if (user User(name: var n)) { … }
// 修正: ‘case’ が抜けているためコンパイルエラーになります
if (user case User(name: var n)) { … }
② 存在しないプロパティを指定してしまう
オブジェクトパターンは、クラスが持つgetter（プロパティ）の名称と完全に一致している必要があります。タイポ（スペルミス）があると、コンパイラが「そんなプロパティは存在しないよ」と優しく（時に厳しく）教えてくれます。
③ 不完全なパターンによる網羅性チェック（Exhaustiveness）
`switch` 式や `switch` 文でオブジェクトパターンを使う場合、Dartのコンパイラは「すべての可能なパターンが網羅されているか」を厳密にチェックします。
もし網羅されていない場合は、「`The switch expression does not handle all possible inputs`（すべての入力を処理していません）」というコンパイルエラーになります。網羅するのが難しい場合は、最後に必ず `default:` や `_ =>` を置く癖をつけておきましょう。
—
5. アーキテクチャの視点：なぜこれが「良いコード」なのか？
最後に、シニアアーキテクチャの視点から、なぜこのオブジェクトパターンを使うことが推奨されるのかをお伝えします。
オブジェクト指向の原則として「カプセル化」がありますが、UI層やビジネスロジック層（BLoCやNotifierなど）で、データの「状態」だけをパパッとパースして画面に反映させたい場面は多々あります。
その度に専用のメソッドを生やしたり、getterを乱用したりしていると、クラスの肥大化（God Object化）を招く原因になります。
オブジェクトパターンを使いこなせるようになると、「データの構造（形）の検証」と「値の取り出し」を安全かつ宣言的に分離できるようになります。余計なgetterを作らずとも、外側からデータの構造をスパッと解体して扱えるため、コードの結合度が下がり、メンテナンス性が劇的に向上するのです。
—
まとめ
- オブジェクトパターンは、インスタンスの型とプロパティを同時にチェックし、値を直接変数に抽出できるDart 3の強力な武器。
- `if-case` や `switch-case` と組み合わせることで、従来のドットアクセスや冗長な条件分岐を劇的にスッキリさせられる。
- プロパティ名と同名の変数をバインドするショートハンドを使いこなすと、コードがさらに洗練される。
ここをクリアできれば、あなたのDartの引き出しは確実に一つ深くなりました。ぜひ今日の開発から、退屈なgetterの呼び出しをオブジェクトパターンに置き換えて、クリーンなコードを楽しんでみてくださいね！