feat: string.capitalize method

README.md

@@ -32,6 +32,7 @@ npm install ext
   - [`random`](docs/string/random.md)
 - `String.prototype`
   - [`campelToHyphen`](docs/string_/camel-to-hyphen.md)
+  - [`capitalize`](docs/string_/capitalize.md)
   - [`includes`](docs/string_/includes.md)
 - `Thenable.prototype`
   - [`finally`](docs/thenable_/finally.md)

docs/string_/capitalize.md

@@ -0,0 +1,9 @@
+# `string.capitalize()` _(ext/string\_/capitalize)_
+
+Capitalize input string, e.g. convert `this is a test` into `This is a test`.
+
+```javascript
+const capitalize = require("ext/string_/capitalize");
+
+capitalize.call("this is a test"); // This is a test
+```

string_/capitalize.js

@@ -0,0 +1,9 @@
+"use strict";
+
+var ensureString = require("type/string/ensure");
+
+module.exports = function () {
+	var input = ensureString(this);
+	if (!input) return input;
+	return input.charAt(0).toUpperCase() + input.slice(1);
+};

test/string_/capitalize.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var assert = require("chai").assert;
+
+var capitalize = require("../../string_/capitalize");
+
+describe("string_/capitalize", function () {
+	it("should capitalize lowercase word", function () {
+		assert.equal(capitalize.call("raz"), "Raz");
+		assert.equal(capitalize.call("raZ"), "RaZ");
+	});
+	it("should return as-is capitalized word", function () {
+		assert.equal(capitalize.call("Raz"), "Raz");
+		assert.equal(capitalize.call("RAZ"), "RAZ");
+	});
+	it("should return emptry string as is", function () { assert.equal(capitalize.call(""), ""); });
+	it("should capitalize single letter", function () { assert.equal(capitalize.call("a"), "A"); });
+	it("should capitalize sentence", function () {
+		assert.equal(capitalize.call("this is a Test"), "This is a Test");
+	});
+});