Re-land http://codereview.chromium.org/9403039/, r124106

ppapi/tests/testing_instance.h

 // Copyright (c) 2011 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.
 
 #ifndef PPAPI_TESTS_TESTING_INSTANCE_H_
 #define PPAPI_TESTS_TESTING_INSTANCE_H_
 
 #include <string>
 
 #include "ppapi/utility/completion_callback_factory.h"
@@ skipping 74 matching lines @@
   int websocket_port() { return websocket_port_; }
 
   // Posts a message to the test page to eval() the script.
   void EvalScript(const std::string& script);
 
   // Sets the given cookie in the current document.
   void SetCookie(const std::string& name, const std::string& value);
 
   void ReportProgress(const std::string& progress_value);
 
+  // Add a post-condition to the JavaScript on the test_case.html page. This
+  // JavaScript code will be run after the instance is shut down and must
+  // evaluate to |true| or the test will fail.
+  void AddPostCondition(const std::string& script);
+
  private:
   void ExecuteTests(int32_t unused);
 
   // Creates a new TestCase for the give test name, or NULL if there is no such
   // test. Ownership is passed to the caller. The given string is split by '_'.
   // The test case name is the first part.
   TestCase* CaseForTestName(const std::string& name);
   // Returns the filter (second part) of the given string. If there is no '_',
   // returns the empty string, which means 'run all tests for this test case'.
   // E.g.:
   //  http://testserver/test_case.html?testcase=PostMessage
   // Otherwise, the part of the testcase after '_' is returned, and the test
   // whose name matches that string (if any) will be run:
   //  http://testserver/test_case.html?testcase=PostMessage_SendingData
   // Runs 'PostMessage_SendingData.
   std::string FilterForTestName(const std::string& name);
 
+  // Sends a test command to the page using PostMessage.
+  void SendTestCommand(const std::string& command);
+  void SendTestCommand(const std::string& command, const std::string& params);
+
   // Appends a list of available tests to the console in the document.
   void LogAvailableTests();
 
   // Appends the given error test to the console in the document.
   void LogError(const std::string& text);
 
   // Appends the given HTML string to the console in the document.
   void LogHTML(const std::string& html);
 
   pp::CompletionCallbackFactory<TestingInstance> callback_factory_;
@@ skipping 16 matching lines @@
 
   // String representing the protocol.  Used for detecting whether we're running
   // with http.
   std::string protocol_;
 
   // WebSocket port.
   int websocket_port_;
 };
 
 #endif  // PPAPI_TESTS_TESTING_INSTANCE_H_