index.js (1555B)
1 /** 2 * @license Apache-2.0 3 * 4 * Copyright (c) 2018 The Stdlib Authors. 5 * 6 * Licensed under the Apache License, Version 2.0 (the "License"); 7 * you may not use this file except in compliance with the License. 8 * You may obtain a copy of the License at 9 * 10 * http://www.apache.org/licenses/LICENSE-2.0 11 * 12 * Unless required by applicable law or agreed to in writing, software 13 * distributed under the License is distributed on an "AS IS" BASIS, 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 * See the License for the specific language governing permissions and 16 * limitations under the License. 17 */ 18 19 'use strict'; 20 21 /** 22 * Define (and/or modify) properties. 23 * 24 * @module @stdlib/utils/define-properties 25 * 26 * @example 27 * var defineProperties = require( '@stdlib/utils/define-properties' ); 28 * 29 * var obj = {}; 30 * defineProperties( obj, { 31 * 'foo': { 32 * 'value': 'bar', 33 * 'writable': false, 34 * 'configurable': false, 35 * 'enumerable': true 36 * }, 37 * 'baz': { 38 * 'value': 13 39 * } 40 * }); 41 * 42 * try { 43 * obj.foo = 'boop'; 44 * } catch ( err ) { 45 * console.log( err.message ); 46 * } 47 */ 48 49 // MODULES // 50 51 var hasDefinePropertiesSupport = require( '@stdlib/assert/has-define-properties-support' ); // eslint-disable-line id-length 52 var builtin = require( './builtin.js' ); 53 var polyfill = require( './polyfill.js' ); 54 55 56 // MAIN // 57 58 var defineProperties; 59 if ( hasDefinePropertiesSupport() ) { 60 defineProperties = builtin; 61 } else { 62 defineProperties = polyfill; 63 } 64 65 66 // EXPORTS // 67 68 module.exports = defineProperties;