Erronous documentation for property decorators?

At https://www.typescriptlang.org/docs/handbook/decorators.html

…it reads under “Property Decorators”

If the property decorator returns a value, it will be used as the Property Descriptor for the member.

NOTE  The return value is ignored if your script target is less than ES5.

I’m running a simple example with target ES6

function MyPropDesc() {
  return function (targetProto: Object, propName: string | symbol)   {
    return {
      get: function() { console.log('in getter') }
    }
  }
}

class SomeClass {
  @MyPropDesc()
  someMember;
}

However, this doesn’t seem to work. Also, when debugging this, my property decorator is being called from Reflect.js’s DecoratePropertyWithoutDescriptor which ignores the result from the descriptor. And…typescript requires the decorator to return void or any. Documentation mistake?

[stephenh]

@mhegazy ah sure, I knew about TS’s “wait for stage 3” stance, which I think makes sense.

I guess it might be getting ahead of things, but a placeholder “Support ESnext decorators once they’re stage 3” issue might be nice for others like me that were wondering about this (e.g. I looked through the open “Domain: decorators” issues and didn’t see anything). Perhaps it’s obvious though.

Also, thanks for the Object.defineProperty hint, using that in the property decorator lets me do exactly what I need in current TS.

[mhegazy]

it has been on my list for a while now. i should file an issue for that and link different issues to it.