feat(text): contains

Author: seb-cr

src/text.ts

@@ -53,6 +53,17 @@ export class Text {
     return this.content.split('\n');
   }
 
+  /**
+   * Returns `true` if the text contains `value`.
+   *
+   * @param value The string or RegExp to search for.
+   */
+  contains(value: string | RegExp): boolean {
+    return typeof value === 'string'
+      ? this.content.includes(value)
+      : value.exec(this.content) !== null;
+  }
+
   /**
    * Replace every occurrance of `searchValue` with `replaceValue`.
    *

tests/text.spec.ts

@@ -23,6 +23,32 @@ describe('Text', () => {
     });
   });
 
+  describe('contains', () => {
+    context('with a string', () => {
+      it('should return true if text contains the string', () => {
+        const text = new Text('one\ntwo\nthree');
+        expect(text.contains('two')).to.be.true;
+      });
+
+      it('should return false if text contains the string', () => {
+        const text = new Text('one\ntwo\nthree');
+        expect(text.contains('blah')).to.be.false;
+      });
+    });
+
+    context('with a regex', () => {
+      it('should return true if text matches the regex', () => {
+        const text = new Text('one\ntwo\nthree');
+        expect(text.contains(/two/)).to.be.true;
+      });
+
+      it('should return false if text matches the regex', () => {
+        const text = new Text('one\ntwo\nthree');
+        expect(text.contains(/blah/)).to.be.false;
+      });
+    });
+  });
+
   describe('replaceAll', () => {
     it('should work with a string', () => {
       const text = new Text('one. two. three');