Adding mapbox-gl branch

mapbox-gl/closure-library/closure/goog/html/testing.js

@@ -0,0 +1,129 @@
+// Copyright 2013 The Closure Library Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS-IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @fileoverview Utilities to create arbitrary values of goog.html types for
+ * testing purposes. These utility methods perform no validation, and the
+ * resulting instances may violate type contracts.
+ *
+ * These methods are useful when types are constructed in a manner where using
+ * the production API is too inconvenient. Please do use the production API
+ * whenever possible; there is value in having tests reflect common usage and it
+ * avoids, by design, non-contract complying instances from being created.
+ */
+
+
+goog.provide('goog.html.testing');
+goog.setTestOnly();
+
+goog.require('goog.html.SafeHtml');
+goog.require('goog.html.SafeScript');
+goog.require('goog.html.SafeStyle');
+goog.require('goog.html.SafeStyleSheet');
+goog.require('goog.html.SafeUrl');
+goog.require('goog.html.TrustedResourceUrl');
+
+
+/**
+ * Creates a SafeHtml wrapping the given value. No validation is performed.
+ *
+ * This function is for use in tests only and must never be used in production
+ * code.
+ *
+ * @param {string} html The string to wrap into a SafeHtml.
+ * @param {?goog.i18n.bidi.Dir=} opt_dir The optional directionality of the
+ *     SafeHtml to be constructed. A null or undefined value signifies an
+ *     unknown directionality.
+ * @return {!goog.html.SafeHtml}
+ */
+goog.html.testing.newSafeHtmlForTest = function(html, opt_dir) {
+  return goog.html.SafeHtml.createSafeHtmlSecurityPrivateDoNotAccessOrElse(
+      html, (opt_dir == undefined ? null : opt_dir));
+};
+
+
+/**
+ * Creates a SafeScript wrapping the given value. No validation is performed.
+ *
+ * This function is for use in tests only and must never be used in production
+ * code.
+ *
+ * @param {string} script The string to wrap into a SafeScript.
+ * @return {!goog.html.SafeScript}
+ */
+goog.html.testing.newSafeScriptForTest = function(script) {
+  return goog.html.SafeScript.createSafeScriptSecurityPrivateDoNotAccessOrElse(
+      script);
+};
+
+
+/**
+ * Creates a SafeStyle wrapping the given value. No validation is performed.
+ *
+ * This function is for use in tests only and must never be used in production
+ * code.
+ *
+ * @param {string} style String to wrap into a SafeStyle.
+ * @return {!goog.html.SafeStyle}
+ */
+goog.html.testing.newSafeStyleForTest = function(style) {
+  return goog.html.SafeStyle.createSafeStyleSecurityPrivateDoNotAccessOrElse(
+      style);
+};
+
+
+/**
+ * Creates a SafeStyleSheet wrapping the given value. No validation is
+ * performed.
+ *
+ * This function is for use in tests only and must never be used in production
+ * code.
+ *
+ * @param {string} styleSheet String to wrap into a SafeStyleSheet.
+ * @return {!goog.html.SafeStyleSheet}
+ */
+goog.html.testing.newSafeStyleSheetForTest = function(styleSheet) {
+  return goog.html.SafeStyleSheet.
+      createSafeStyleSheetSecurityPrivateDoNotAccessOrElse(styleSheet);
+};
+
+
+/**
+ * Creates a SafeUrl wrapping the given value. No validation is performed.
+ *
+ * This function is for use in tests only and must never be used in production
+ * code.
+ *
+ * @param {string} url String to wrap into a SafeUrl.
+ * @return {!goog.html.SafeUrl}
+ */
+goog.html.testing.newSafeUrlForTest = function(url) {
+  return goog.html.SafeUrl.createSafeUrlSecurityPrivateDoNotAccessOrElse(url);
+};
+
+
+/**
+ * Creates a TrustedResourceUrl wrapping the given value. No validation is
+ * performed.
+ *
+ * This function is for use in tests only and must never be used in production
+ * code.
+ *
+ * @param {string} url String to wrap into a TrustedResourceUrl.
+ * @return {!goog.html.TrustedResourceUrl}
+ */
+goog.html.testing.newTrustedResourceUrlForTest = function(url) {
+  return goog.html.TrustedResourceUrl.
+      createTrustedResourceUrlSecurityPrivateDoNotAccessOrElse(url);
+};