Home | History | Annotate | Download | only in plugin
      1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef CONTENT_TEST_PLUGIN_PLUGIN_TEST_H_
      6 #define CONTENT_TEST_PLUGIN_PLUGIN_TEST_H_
      7 
      8 #include <string>
      9 
     10 #include "third_party/npapi/bindings/npapi.h"
     11 #include "third_party/npapi/bindings/nphostapi.h"
     12 
     13 namespace NPAPIClient {
     14 
     15 // A PluginTest represents an instance of the plugin, which in
     16 // our case is a test case.
     17 class PluginTest {
     18  public:
     19   // Constructor.
     20   PluginTest(NPP id, NPNetscapeFuncs *host_functions);
     21 
     22   // Destructor
     23   virtual ~PluginTest();
     24 
     25   // Returns true if the test runs in windowless plugin mode.
     26   virtual bool IsWindowless() const;
     27 
     28   //
     29   // NPAPI Functions
     30   //
     31   virtual NPError New(uint16 mode, int16 argc, const char* argn[],
     32                       const char* argv[], NPSavedData* saved);
     33   virtual NPError Destroy();
     34   virtual NPError SetWindow(NPWindow* pNPWindow);
     35   virtual NPError NewStream(NPMIMEType type, NPStream* stream,
     36                             NPBool seekable, uint16* stype);
     37   virtual int32   WriteReady(NPStream *stream);
     38   virtual int32   Write(NPStream *stream, int32 offset, int32 len,
     39                         void *buffer);
     40   virtual NPError DestroyStream(NPStream *stream, NPError reason);
     41   virtual void    StreamAsFile(NPStream* stream, const char* fname);
     42   virtual void    URLNotify(const char* url, NPReason reason, void* data);
     43   virtual int16   HandleEvent(void* event);
     44   virtual void    URLRedirectNotify(const char* url, int32_t status,
     45                                     void* notify_data);
     46 
     47   // Returns true if the test has not had any errors.
     48   bool Succeeded() { return test_status_.length() == 0; }
     49 
     50   // Sets an error for the test case.  Appends the msg to the
     51   // error that will be returned from the test.
     52   void SetError(const std::string &msg);
     53 
     54   // Expect two string values are equal, and if not, logs an
     55   // appropriate error about it.
     56   void ExpectStringLowerCaseEqual(const std::string &val1,
     57                                   const std::string &val2);
     58 
     59   // Expect two values to not be equal, and if they are
     60   // logs an appropriate error about it.
     61   void ExpectAsciiStringNotEqual(const char *val1, const char *val2);
     62 
     63   // Expect two integer values are equal, and if not, logs an
     64   // appropriate error about it.
     65   void ExpectIntegerEqual(int val1, int val2);
     66 
     67   // Signals to the Test that invoked us that the test is
     68   // completed.  This is done by forcing the plugin to
     69   // set a cookie in the browser window, which the test program
     70   // is waiting for.  Note - because this is done by
     71   // using javascript, the browser must have the frame
     72   // setup before the plugin calls this function.  So plugin
     73   // tests MUST NOT call this function prior to having
     74   // received the SetWindow() callback from the browser.
     75   void SignalTestCompleted();
     76 
     77  protected:
     78   // Helper function to lookup names in the input array.
     79   // If the name is found, returns the value, otherwise
     80   // returns NULL.
     81   const char *GetArgValue(const char *name, const int16 argc,
     82                           const char *argn[], const char *argv[]);
     83 
     84   // Access to the list of functions provided
     85   // by the NPAPI host.
     86   NPNetscapeFuncs *HostFunctions() { return host_functions_; }
     87 
     88   // The NPP Identifier for this plugin instance.
     89   NPP id() { return id_; }
     90   std::string test_id() const { return test_id_; }
     91   std::string test_name() const { return test_name_; }
     92   bool test_completed() const { return test_completed_; }
     93  private:
     94   NPP                       id_;
     95   NPNetscapeFuncs *         host_functions_;
     96   std::string               test_name_;
     97   std::string               test_id_;
     98   std::string               test_status_;
     99   bool                      test_completed_;
    100 };
    101 
    102 }  // namespace NPAPIClient
    103 
    104 #endif  // CONTENT_TEST_PLUGIN_PLUGIN_TEST_H_
    105