Detect class in @throws statement.

Add test.

Author: kagg-design

WPForms/Sniffs/PHP/UseStatementSniff.php

@@ -131,6 +131,10 @@ private function findInParamsDescription( $phpcsFile, $entityName, $element ) {
 			return false;
 		}
 
+		if ( $this->findInThrows( $phpcsFile, $entityName, $nextElement ) ) {
+			return true;
+		}
+
 		if ( $tokens[ $nextElement ]['content'] !== '@param' ) {
 			return $this->findInParamsDescription( $phpcsFile, $entityName, $nextElement );
 		}
@@ -147,4 +151,31 @@ private function findInParamsDescription( $phpcsFile, $entityName, $element ) {
 
 		return $this->findInParamsDescription( $phpcsFile, $entityName, $nextElement );
 	}
+
+	/**
+	 * Find function/objects/class in the PHPDoc @throws.
+	 *
+	 * @since {VERSION}
+	 *
+	 * @param File   $phpcsFile  The PHP_CodeSniffer file where the token was found.
+	 * @param string $entityName Function/objects/class name.
+	 * @param int    $stackPtr   Current search position.
+	 *
+	 * @return bool
+	 */
+	private function findInThrows( $phpcsFile, $entityName, $stackPtr ) {
+
+		$tokens = $phpcsFile->getTokens();
+
+		if ( $tokens[ $stackPtr ]['content'] === '@throws' ) {
+			$closePtr   = $phpcsFile->findNext( T_DOC_COMMENT_CLOSE_TAG, $stackPtr + 1 );
+			$commentPtr = $phpcsFile->findNext( T_DOC_COMMENT_STRING, $stackPtr + 1, $closePtr );
+
+			if ( $commentPtr && $entityName === explode( ' ', $tokens[ $commentPtr ]['content'] )[0] ) {
+				return true;
+			}
+		}
+
+		return false;
+	}
 }

WPForms/Tests/TestedFiles/PHP/UseStatement.php

@@ -9,6 +9,7 @@
 use Some\Name\Space\Type2;
 use Some\Name\Space\Type3;
 use Some\Name\Space\Type4;
+use Some\Name\Space\Type5;
 use Unused\Name\Space\Example3;
 use Unused\Name\Space\Example4;
 
@@ -45,6 +46,7 @@ public function test( $type ) {}
 
 	/**
 	 * @return Type4
+	 * @throws Type5 Type5.
 	 */
 	public function test2() {}
 }

WPForms/Tests/Tests/PHP/UseStatementTest.php

@@ -21,6 +21,6 @@ public function testProcess() {
 
 		$phpcsFile = $this->process( new UseStatementSniff() );
 
-		$this->fileHasErrors( $phpcsFile, 'UnusedUseStatement', [ 12, 13, 16 ] );
+		$this->fileHasErrors( $phpcsFile, 'UnusedUseStatement', [ 13, 14, 17 ] );
 	}
 }