feat(internal): getPropertyValue

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

src/internal/__tests__/get-property-value.spec.ts

@@ -0,0 +1,21 @@
+/**
+ * @file Unit Tests - getPropertyValue
+ * @module tsconfig-utils/internal/tests/unit/getPropertyValue
+ */
+
+import testSubject from '../get-property-value'
+
+describe('unit:internal/getPropertyValue', () => {
+  it('should return extracted property value', () => {
+    // Arrange
+    const cases: [...Parameters<typeof testSubject>, unknown][] = [
+      [null, 'property', undefined],
+      [{ target: 'es2020' }, 'target', 'es2020']
+    ]
+
+    // Act + Expect
+    cases.forEach(([object, property, expected]) => {
+      expect(testSubject(object, property)).to.equal(expected)
+    })
+  })
+})

src/internal/get-property-value.ts

@@ -0,0 +1,30 @@
+/**
+ * @file Internal - getPropertyValue
+ * @module tsconfig-utils/internal/getPropertyValue
+ */
+
+import type { Nilable, ObjectUnknown } from '@flex-development/tutils'
+
+/**
+ * Extracts a property value from the given `object`.
+ *
+ * Returns `undefined` if the given `property` is not defined.
+ *
+ * **Note**: If `object` is `null` or `undefined`, it will be converted to an
+ * empty object first.
+ *
+ * @template T - Object type
+ * @template K - Object property name
+ *
+ * @param {Nilable<T>} object - Object to evaluate, `null`, or `undefined`
+ * @param {string} property - Object property name
+ * @return {T[K] | undefined} Property value or `undefined`
+ */
+function getPropertyValue<T extends ObjectUnknown, K extends string = string>(
+  object: Nilable<T>,
+  property: K
+): T[K] | undefined {
+  return Object.getOwnPropertyDescriptor(object ?? {}, property)?.value as T[K]
+}
+
+export default getPropertyValue

src/internal/index.ts

@@ -3,6 +3,7 @@
  * @module tsconfig-utils/internal
  */
 
+export { default as getPropertyValue } from './get-property-value'
 export { default as isDirectory } from './is-directory'
 export { default as isFile } from './is-file'
 export { default as parseJSON } from './parse-json'