require-passing-this

✅ recommended を使用した場合、このルールが有効になります。

🔧 このルールによってエラーになるコードは ESLint の --fix コマンド で自動修正できます。

このルールは Construct に this を渡すことを強制します。
(このルールは Construct を継承するクラスにのみ適用されます)

AWS CDK リソースを作成するとき、Construct に this を渡すことは正しいリソース階層を維持するために重要です。
scope のような他の値を使用すると、次のような問題が発生する可能性があります

• 生成される CloudFormation テンプレートのリソース階層が正しくない
• 予期しないリソースの命名

オプション

このルールには以下のプロパティを持つオプションがあります：

allowNonThisAndDisallowScope (デフォルト: false)

true の場合、Construct コンストラクタの第一引数に this 以外の値を指定できるようになります (ただし、scope 変数の使用は禁止されます)。 これは、あるコンストラクトを別のコンストラクトの子として作成したい場合に便利です。

※recommended ルールセットでは true が指定されています

---

🔧 使用方法

// eslint.config.mjs
export default [
  {
    // ... some configs
    rules: {
      // デフォルト: すべての Construct インスタンス化で this を要求
      "cdk/require-passing-this": "error",

      // this 以外の値を許可 (scope 変数は禁止)
      "cdk/require-passing-this": [
        "error",
        { allowNonThisAndDisallowScope: true },
      ],
    },
  },
];

✅ 正しい例

import { Construct } from "constructs";
import { Bucket } from "aws-cdk-lib/aws-s3";

export class MyConstruct extends Construct {
  constructor(scope: Construct, id: string) {
    super(scope, id);

    // ✅ this を使用できます
    new Bucket(this, "SampleBucket");

    // ✅ allowNonThisAndDisallowScope が true の場合、this 以外の変数を使用できます(ただし、scope 変数は禁止)
    const sample = new SampleConstruct(this, "Sample");
    new OtherConstruct(sample, "Child"); // allowNonThisAndDisallowScope が true の場合は有効
  }
}

❌ 不正な例

import { Construct } from "constructs";
import { Bucket } from "aws-cdk-lib/aws-s3";

export class MyConstruct extends Construct {
  constructor(scope: Construct, id: string) {
    super(scope, id);

    // ❌ scope を使用すべきではありません
    new Bucket(scope, "SampleBucket"); // allowNonThisAndDisallowScope が true の場合でも無効
  }
}