dom/base/BodyUtil.h
author Sylvestre Ledru <sledru@mozilla.com>
Thu, 17 Aug 2017 11:13:01 +0200
changeset 648192 c236dfe7dc98c387219d7cb45d0693560db708fd
parent 335313 faaf448b9788574b99b0fd0dc554879899edcdf4
child 489671 05d9746016f47666c00390aacc9f9d62c8ffffb4
permissions -rw-r--r--
indent all (with js specific coding style) MozReview-Commit-ID: LU1md2wyB8

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef mozilla_dom_BodyUtil_h
#define mozilla_dom_BodyUtil_h

#include "nsString.h"
#include "nsError.h"

#include "mozilla/ErrorResult.h"
#include "mozilla/dom/File.h"
#include "mozilla/dom/FormData.h"

namespace mozilla {
namespace dom {

class BodyUtil final
{
private:
  BodyUtil() = delete;

public:
  /**
   * Creates an array buffer from an array, assigning the result to |aValue|.
   * The array buffer takes ownership of |aInput|, which must be allocated
   * by |malloc|.
   */
  static void ConsumeArrayBuffer(JSContext* aCx,
                                 JS::MutableHandle<JSObject*> aValue,
                                 uint32_t aInputLength,
                                 uint8_t* aInput,
                                 ErrorResult& aRv);

  /**
   * Creates an in-memory blob from an array. The blob takes ownership of
   * |aInput|, which must be allocated by |malloc|.
   */
  static already_AddRefed<Blob> ConsumeBlob(nsISupports* aParent,
                                            const nsString& aMimeType,
                                            uint32_t aInputLength,
                                            uint8_t* aInput,
                                            ErrorResult& aRv);

  /**
   * Creates a form data object from a UTF-8 encoded |aStr|. Returns |nullptr|
   * and sets |aRv| to MSG_BAD_FORMDATA if |aStr| contains invalid data.
   */
  static already_AddRefed<FormData> ConsumeFormData(nsIGlobalObject* aParent,
                                                    const nsCString& aMimeType,
                                                    const nsCString& aStr,
                                                    ErrorResult& aRv);

  /**
   * UTF-8 decodes |aInput| into |aText|. The caller may free |aInput|
   * once this method returns.
   */
  static nsresult ConsumeText(uint32_t aInputLength,
                              uint8_t* aInput,
                              nsString& aText);

  /**
   * Parses a UTF-8 encoded |aStr| as JSON, assigning the result to |aValue|.
   * Sets |aRv| to a syntax error if |aStr| contains invalid data.
   */
  static void ConsumeJson(JSContext* aCx,
                          JS::MutableHandle<JS::Value> aValue,
                          const nsString& aStr,
                          ErrorResult& aRv);
};

} // namespace dom
} // namespace mozilla

#endif // mozilla_dom_BodyUtil_h