Quelle  FormatZlib.h

/* 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 DOM_COMPRESSION_FORMATZLIB_H_
#define DOM_COMPRESSION_FORMATZLIB_H_

#include "BaseAlgorithms.h"
#include "mozilla/dom/TransformerCallbackHelpers.h"
#include "zlib.h"

// See the zlib manual in https://www.zlib.net/manual.html or in
// https://searchfox.org/firefox-main/source/modules/zlib/src/zlib.h

namespace mozilla::dom {
enum class CompressionFormat : uint8_t;
}

namespace mozilla::dom::compression {

class ZLibCompressionStreamAlgorithms : public CompressionStreamAlgorithms {
 public:
  NS_DECL_ISUPPORTS_INHERITED
  NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(ZLibCompressionStreamAlgorithms,
                                           CompressionStreamAlgorithms)

  static Result<already_AddRefed<ZLibCompressionStreamAlgorithms>, nsresult>
  Create(CompressionFormat format);

 private:
  ZLibCompressionStreamAlgorithms() = default;

  [[nodiscard]] nsresult Init(CompressionFormat format);

  // Shared by:
  // https://wicg.github.io/compression/#compress-and-enqueue-a-chunk
  // https://wicg.github.io/compression/#compress-flush-and-enqueue
  void Compress(JSContext* aCx, Span<const uint8_t> aInput,
                JS::MutableHandleVector<JSObject*> aOutput, Flush aFlush,
                ErrorResult& aRv) override;

  ~ZLibCompressionStreamAlgorithms() override;

  z_stream mZStream = {};
};

class ZLibDecompressionStreamAlgorithms : public DecompressionStreamAlgorithms {
 public:
  NS_DECL_ISUPPORTS_INHERITED
  NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(ZLibDecompressionStreamAlgorithms,
                                           DecompressionStreamAlgorithms)

  static Result<already_AddRefed<ZLibDecompressionStreamAlgorithms>, nsresult>
  Create(CompressionFormat format);

 private:
  ZLibDecompressionStreamAlgorithms() = default;

  [[nodiscard]] nsresult Init(CompressionFormat format);

  // Shared by:
  // https://wicg.github.io/compression/#decompress-and-enqueue-a-chunk
  // https://wicg.github.io/compression/#decompress-flush-and-enqueue
  // All data errors throw TypeError by step 2: If this results in an error,
  // then throw a TypeError.
  bool Decompress(JSContext* aCx, Span<const uint8_t> aInput,
                  JS::MutableHandleVector<JSObject*> aOutput, Flush aFlush,
                  ErrorResult& aRv) override;

  ~ZLibDecompressionStreamAlgorithms() override;

  z_stream mZStream = {};
};

}  // namespace mozilla::dom::compression

#endif  // DOM_COMPRESSION_FORMATZLIB_H_