3 * Test class for SpecialSearch class
4 * Copyright © 2012, Antoine Musso
6 * @author Antoine Musso
10 class SpecialSearchTest
extends MediaWikiTestCase
{
13 * @covers SpecialSearch::load
14 * @dataProvider provideSearchOptionsTests
15 * @param array $requested Request parameters. For example:
16 * array( 'ns5' => true, 'ns6' => true). Null to use default options.
17 * @param array $userOptions User options to test with. For example:
18 * array('searchNs5' => 1 );. Null to use default options.
19 * @param string $expectedProfile An expected search profile name
20 * @param array $expectedNS Expected namespaces
21 * @param string $message
23 public function testProfileAndNamespaceLoading( $requested, $userOptions,
24 $expectedProfile, $expectedNS, $message = 'Profile name and namespaces mismatches!'
26 $context = new RequestContext
;
28 $this->newUserWithSearchNS( $userOptions )
31 $context->setRequest( new FauxRequest( array(
36 $context->setRequest( new FauxRequest( $requested ) );
37 $search = new SpecialSearch();
38 $search->setContext( $context );
42 * Verify profile name and namespace in the same assertion to make
43 * sure we will be able to fully compare the above code. PHPUnit stop
44 * after an assertion fail.
47 array( /** Expected: */
48 'ProfileName' => $expectedProfile,
49 'Namespaces' => $expectedNS,
52 'ProfileName' => $search->getProfile(),
53 'Namespaces' => $search->getNamespaces(),
59 public static function provideSearchOptionsTests() {
60 $defaultNS = SearchEngine
::defaultNamespaces();
61 $EMPTY_REQUEST = array();
67 * <Web Request>, <User options>
68 * Followed by expected values:
69 * <ProfileName>, <NSList>
70 * Then an optional message.
73 $EMPTY_REQUEST, $NO_USER_PREF,
74 'default', $defaultNS,
75 'Bug 33270: No request nor user preferences should give default profile'
78 array( 'ns5' => 1 ), $NO_USER_PREF,
79 'advanced', array( 5 ),
80 'Web request with specific NS should override user preference'
83 $EMPTY_REQUEST, array(
86 ) +
array_fill_keys( array_map( function ( $ns ) {
89 'advanced', array( 2, 14 ),
90 'Bug 33583: search with no option should honor User search preferences'
91 . ' and have all other namespace disabled'
97 * Helper to create a new User object with given options
98 * User remains anonymous though
99 * @param array|null $opt
101 function newUserWithSearchNS( $opt = null ) {
102 $u = User
::newFromId( 0 );
103 if ( $opt === null ) {
106 foreach ( $opt as $name => $value ) {
107 $u->setOption( $name, $value );
114 * Verify we do not expand search term in <title> on search result page
115 * https://gerrit.wikimedia.org/r/4841
117 public function testSearchTermIsNotExpanded() {
118 $this->setMwGlobals( array(
119 'wgSearchType' => null,
122 # Initialize [[Special::Search]]
123 $search = new SpecialSearch();
124 $search->getContext()->setTitle( Title
::newFromText( 'Special:Search' ) );
127 # Simulate a user searching for a given term
128 $term = '{{SITENAME}}';
129 $search->showResults( $term );
131 # Lookup the HTML page title set for that page
139 '/' . preg_quote( $term, '/' ) . '/',
141 "Search term '{$term}' should not be expanded in Special:Search <title>"
145 public function provideRewriteQueryWithSuggestion() {
148 'With suggestion and no rewritten query shows did you mean',
149 '/Did you mean: <a[^>]+>first suggestion/',
150 new SpecialSearchTestMockResultSet( 'first suggestion', null, array(
151 SearchResult
::newFromTitle( Title
::newMainPage() ),
156 'With rewritten query informs user of change',
157 '/Showing results for <a[^>]+>first suggestion/',
158 new SpecialSearchTestMockResultSet( 'asdf', 'first suggestion', array(
159 SearchResult
::newFromTitle( Title
::newMainPage() ),
164 'When both queries have no results user gets no results',
165 '/There were no results matching the query/',
166 new SpecialSearchTestMockResultSet( 'first suggestion', 'first suggestion', array() ),
172 * @dataProvider provideRewriteQueryWithSuggestion
174 public function testRewriteQueryWithSuggestion( $message, $expectRegex, $results ) {
175 $mockSearchEngine = $this->mockSearchEngine( $results );
176 $search = $this->getMockBuilder( 'SpecialSearch' )
177 ->setMethods( array( 'getSearchEngine' ) )
179 $search->expects( $this->any() )
180 ->method( 'getSearchEngine' )
181 ->will( $this->returnValue( $mockSearchEngine ) );
183 $search->getContext()->setTitle( Title
::makeTitle( NS_SPECIAL
, 'Search' ) );
184 $search->getContext()->setLanguage( Language
::factory( 'en' ) );
186 $search->showResults( 'this is a fake search' );
188 $html = $search->getContext()->getOutput()->getHTML();
189 foreach ( (array)$expectRegex as $regex ) {
190 $this->assertRegExp( $regex, $html, $message );
194 protected function mockSearchEngine( $results ) {
195 $mock = $this->getMockBuilder( 'SearchEngine' )
196 ->setMethods( array( 'searchText', 'searchTitle' ) )
199 $mock->expects( $this->any() )
200 ->method( 'searchText' )
201 ->will( $this->returnValue( $results ) );
207 class SpecialSearchTestMockResultSet
extends SearchResultSet
{
209 protected $suggestion;
211 public function __construct(
213 $rewrittenQuery = null,
214 array $results = array(),
215 $containedSyntax = false
217 $this->suggestion
= $suggestion;
218 $this->rewrittenQuery
= $rewrittenQuery;
219 $this->results
= $results;
220 $this->containedSyntax
= $containedSyntax;
223 public function numRows() {
224 return count( $this->results
);
227 public function getTotalHits() {
228 return $this->numRows();
231 public function hasSuggestion() {
232 return $this->suggestion
!== null;
235 public function getSuggestionQuery() {
236 return $this->suggestion
;
239 public function getSuggestionSnippet() {
240 return $this->suggestion
;
243 public function hasRewrittenQuery() {
244 return $this->rewrittenQuery
!== null;
247 public function getQueryAfterRewrite() {
248 return $this->rewrittenQuery
;
251 public function getQueryAfterRewriteSnippet() {
252 return htmlspecialchars( $this->rewrittenQuery
);