reflect-annotations

Set and inspect annotation metadata on JavaScript classes and methods

Usage no npm install needed!

<script type="module">
  import reflectAnnotations from 'https://cdn.skypack.dev/reflect-annotations';
</script>

README

reflect-annotations

Annotations are namespaced metadata fields used for defining non-destructive runtime metadata on classes, methods and parameters.

Example

import { createAnnotationFactory, reflectAnnotations } from 'reflect-annotations'

function ExampleAnnotation (name, size) {
  this.name = name
  this.size = size
}
function ExampleAnnotation2 (name, size) {
  this.name = name
  this.size = size
}

const Example = createAnnotationFactory(ExampleAnnotation)
const Example2 = createAnnotationFactory(ExampleAnnotation2)

class MyClass {
  @Example('test', 42)
  @Example2('test', 42)
  method(@Example() a, b, @Example2() c) {
    //do something
  }
}
console.log(reflectAnnotations(MyClass))
//[{
//  name: 'method',
//  declaredOrder: true,
//  classAnnotations: [],
//  methodAnnotations: [ ExampleAnnotation {}, ExampleAnnotation2 {} ],
//  parameterAnnotations: [ ExampleAnnotation {}, undefined, ExampleAnnotation2 {} ]
//}]
console.log(reflectAnnotations(MyClass, { declaredOrder: false }))
//[{
//  name: 'method',
//  declaredOrder: false,
//  classAnnotations: [],
//  methodAnnotations: [ ExampleAnnotation2 {}, ExampleAnnotation {} ],
//  parameterAnnotations: [ ExampleAnnotation {}, undefined, ExampleAnnotation2 {} ]
//}]

In the above example a decorator is created when Example is invoked at parse time. The decorator adds an ExampleAnnotation instance to the target's list of annotations. These "Annotations" are non destructive metadata.

By default annotations are processed in "declared order" this is the order that they're declared (top to bottom) The opposite of this order would be "parsed order" which is the order that the javascript engine executes them.

The order they're recorded in can be adjusted by passing the { declaredOrder: false } as a second optional options argument.

Requirements