stampit API
Search…
API
@stamp/privatize
Makes all properties and optional methods private
This stamp (aka behavior) will create a proxy object. Its methods would delegate all the calls to the original object instance.
All the properties are made private. Methods privatization is optional and can be done via the
privatizeMethods static function.Usage
1
import Privatize from '@stamp/privatize';
2
​
3
import Auth from './stamps/auth';
4
​
5
const AuthWithPrivateProperties = Auth.compose(Privatize);
6
​
7
const AuthWithPrivatePropertiesAndMethod = Auth.compose(Privatize).privatizeMethods('setPassword');
Copied!
Or if you don't want to import the stamp you can import only the method:
1
import {privatizeMethods} from '@stamp/privatize';
2
const AuthWithPrivatePropertiesAndMethod = Auth.compose(privatizeMethods('setPassword'));
Copied!
Warning!
Every property you assign in the initializers will be private.
1
const Original = compose({
2
initializers: function () {
3
this.foo = 42; // THIS WILL BE PRIVATE
4
this.bar = function () {}; // THIS WILL BE PRIVATE TOO
5
}
6
});
7
Original().foo === undefined;
8
Original().bar === undefined;
Copied!
This is a neat feature since you don't need to use JS closures to hide variables from external users.
Example
1
let accessPassword, accessSetPassword;
2
const Original = compose({
3
properties: {password: '123'},
4
methods: {
5
setPassword(value) { this.password = value; },
6
checkAccess() {
7
accessPassword = this.password;
8
accessSetPassword = this.setPassword;
9
}
10
}
11
});
12
​
13
// Add Privatize behavior, additionally protect the 'setPassword' method
14
const Stamp = Original.compose(Privatize).privatizeMethods('setPassword');
15
​
16
// All properties and the method 'setPassword' are undefined
17
const instance = Stamp();
18
expect(instance.password).toBeUndefined();
19
expect(instance.setPassword).toBeUndefined();
20
​
21
// But the 'checkAccess' method have access to the properties and 'setPassword'
22
instance.checkAccess();
23
expect(accessPassword).toBe('123');
24
expect(accessSetPassword).toBe(Original.compose.methods.setPassword);
Copied!
Smart use of configuration
If you ever was thinking how cool if it was having
configuration (and deepConfiguration) accessible in your method without explicitly exposing it through initializer, with privatize stamp you can simply do this. First make your own extension to Private stamp.1
import Privatize from '@stamp/privatize';
2
const ConfiguredPrivatize = Privatize.compose({
3
initializers: [(_, {stamp, instance}) => {
4
instance.stampConfiguration = stamp.compose.configuration;
5
instance.stampDeepConfiguration = stamp.compose.deepConfiguration;
6
}]
7
})
8
export default ConfiguredPrivatize;
Copied!
Then you can use for your other stamps and being able to access configuration within any method while still have it hidden from public sight.
1
compose(ConfiguredPrivatize, {
2
configuration: {
3
secret: 'mykey'
4
},
5
methods: {
6
encrypt(value) {
7
const { secret } = this.stampConfiguration;
8
// run encryption with secret while it's still hidden from outside
9
}
10
}
11
})
Copied!
Last modified 4yr ago
Copy link