Add web shell matcher for address field.

ios/web/shell/test/earl_grey/shell_matchers.h

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #import <EarlGrey/EarlGrey.h>
 
 namespace web {
 
 // Shorthand for GREYMatchers::matcherForWebViewContainingText.
 id<GREYMatcher> webViewContainingText(NSString* text);
 
+// Shorthand for GREYMatchers::matcherForAddressFieldTextEqualTo.
+id<GREYMatcher> addressFieldText(NSString* text);
+
 // Shorthand for GREYMatchers::matcherForBackButton.
 id<GREYMatcher> backButton();
 
 // Shorthand for GREYMatchers::matcherForForwardButton.
 id<GREYMatcher> forwardButton();
 
 // Shorthand for GREYMatchers::matcherForAddressField.
 id<GREYMatcher> addressField();
 
 }  // namespace web
 
 @interface GREYMatchers (WebShellAdditions)
 
 // Matcher for WKWebView containing |text|.
 + (id<GREYMatcher>)matcherForWebViewContainingText:(NSString*)text;
 
+// Matcher for web shell address field text property equal to |text|.
++ (id<GREYMatcher>)matcherForAddressFieldTextEqualTo:(NSString*)text;

[Eugene But (OOO till 7-30), 2016/05/09 15:59:08]

s/matcherForAddressFieldTextEqualTo/matcherForAddressFieldContainingText:

1.) Word before argument should describe the argument
2.) For consistency with the method above

[baxley, 2016/05/09 17:11:43]

I changed to matcherForAddressFieldEqualToText to address your first comment.

Regarding the second point, these APIs don't do the same thing. The first checks
if |text| is anywhere in the web view text. This API checks that |text| is equal
to the text property of the address field.

I think for now it's good to have and equalTo method to be strict on URLs.

+
 // Matcher for back button in web shell.
 + (id<GREYMatcher>)matcherForWebShellBackButton;
 
 // Matcher for forward button in web shell.
 + (id<GREYMatcher>)matcherForWebShellForwardButton;
 
 // Matcher for address field in web shell.
 + (id<GREYMatcher>)matcherForWebShellAddressField;
 
 @end