feat(inversify-code-examples): add bindingWhenSyntaxApiWhen example

packages/docs/tools/inversify-code-examples/src/examples/v7/bindingWhenSyntaxApiWhen.int.spec.ts

@@ -0,0 +1,9 @@
+import { describe, expect, it } from '@jest/globals';
+
+import { ninjaDamage } from './bindingWhenSyntaxApiWhen';
+
+describe('BindingWhenSyntax API (when)', () => {
+  it('should bind right ninja weapon', () => {
+    expect(ninjaDamage).toBe(5);
+  });
+});

packages/docs/tools/inversify-code-examples/src/examples/v7/bindingWhenSyntaxApiWhen.ts

@@ -0,0 +1,61 @@
+import {
+  BindingMetadata,
+  Container,
+  inject,
+  injectable,
+  named,
+} from 'inversify7';
+
+interface Weapon {
+  damage: number;
+}
+
+export class Katana implements Weapon {
+  public readonly damage: number = 10;
+}
+
+export class Shuriken implements Weapon {
+  public readonly damage: number = 5;
+}
+
+const container: Container = new Container();
+
+// Begin-example
+const ninjaId: symbol = Symbol.for('Ninja');
+const weaponId: symbol = Symbol.for('Weapon');
+
+@injectable()
+class Ninja {
+  constructor(
+    @inject(weaponId)
+    @named('shuriken')
+    public readonly weapon: Weapon,
+  ) {}
+}
+
+container.bind<Ninja>(ninjaId).to(Ninja);
+
+const whenTargetNamedConstraint: (
+  name: string,
+) => (bindingMetadata: BindingMetadata) => boolean =
+  (name: string) =>
+  (bindingMetadata: BindingMetadata): boolean =>
+    bindingMetadata.name === name;
+
+container
+  .bind<Weapon>(weaponId)
+  .to(Katana)
+  .when(whenTargetNamedConstraint('katana'));
+
+container
+  .bind<Weapon>(weaponId)
+  .to(Shuriken)
+  .when(whenTargetNamedConstraint('shuriken'));
+
+const ninja: Ninja = container.get(ninjaId);
+
+// Returns 5
+const ninjaDamage: number = ninja.weapon.damage;
+// End-example
+
+export { ninjaDamage };