feat: add padStart, padEnd

src/index.ts

@@ -55,6 +55,8 @@ export { default as mapValues } from './mapValues'
 export { default as noop } from './noop'
 export { default as objectToQueryString } from './objectToQueryString'
 export { default as omit } from './omit'
+export { default as padEnd } from './padEnd'
+export { default as padStart } from './padStart'
 export { default as parseCSSValue } from './parseCSSValue'
 export { default as pick } from './pick'
 export { default as placeKitten } from './placeKitten'

src/padEnd.ts

@@ -0,0 +1,18 @@
+import repeat from './repeat'
+
+/**
+ * 在 str 右侧填充字符。
+ *
+ * @param str 要填充的字符串
+ * @param [length=0] 目标长度
+ * @param [chars=' '] 填充字符
+ * @returns 填充后的字符串
+ */
+export default function padEnd(str: string, length: number = 0, chars: string = ' '): string {
+  let suffix = ''
+  if (length > str.length) {
+    const suffixLength = length - str.length
+    suffix = repeat(chars, length - str.length).slice(0, suffixLength)
+  }
+  return str + suffix
+}

src/padStart.ts

@@ -0,0 +1,18 @@
+import repeat from './repeat'
+
+/**
+ * 在 str 左侧填充字符。
+ *
+ * @param str 要填充的字符串
+ * @param [length=0] 目标长度
+ * @param [chars=' '] 填充字符
+ * @returns 填充后的字符串
+ */
+export default function padStart(str: string, length: number = 0, chars: string = ' '): string {
+  let prefix = ''
+  if (length > str.length) {
+    const prefixLength = length - str.length
+    prefix = repeat(chars, length - str.length).slice(0, prefixLength)
+  }
+  return prefix + str
+}

test/index.test.ts

@@ -1446,3 +1446,21 @@ describe('placeKitten', () => {
     expect(vtils.placeKitten(200, 100)).toMatch(/200\/100/)
   })
 })
+
+describe('padStart', () => {
+  test('ok', () => {
+    expect(vtils.padStart('1', 3, '0')).toBe('001')
+    expect(vtils.padStart('abc', 6)).toBe('   abc')
+    expect(vtils.padStart('abc', 6, '_-')).toBe('_-_abc')
+    expect(vtils.padStart('abc', 3)).toBe('abc')
+  })
+})
+
+describe('padEnd', () => {
+  test('ok', () => {
+    expect(vtils.padEnd('1', 3, '0')).toBe('100')
+    expect(vtils.padEnd('abc', 6)).toBe('abc   ')
+    expect(vtils.padEnd('abc', 6, '_-')).toBe('abc_-_')
+    expect(vtils.padEnd('abc', 3)).toBe('abc')
+  })
+})