Bitbybit Docs
    Preparing search index...

    Class JSONBitByBit

    Membaca dan mengubah nilai di dalam data JSON. Jalur seperti $.parts[0].name mengikuti sintaks JSONPath: $ adalah akar, .name masuk ke sebuah properti, [0] ke sebuah entri daftar dan ..name mencari pada kedalaman mana pun. Metode-metode di sini mengkueri, mengatur dan mencantumkan berdasarkan jalur, bekerja pada properti tunggal dan menampilkan pratinjau data melalui aplikasi; setiap perubahan kembali sebagai salinan yang diubah, masukan tetap apa adanya.

    Index

    Constructors

    create

    • Memberikan objek kosong baru tanpa properti, titik awal untuk setValueOnProp dan setValue.

      Returns any

      Objek kosong

      const settings = bitbybit.json.createEmpty();
      const withWidth = bitbybit.json.setValueOnProp({ json: settings, property: "width", value: 10 });

    jsonpath

    • Menemukan setiap nilai dalam JSON yang cocok dengan ekspresi JSONPath dan memberikannya sebagai daftar, bahkan jika hanya ada satu.

      $.parts[*].name mencantumkan semua nama part dan $..radius setiap radius pada kedalaman apa pun; filter JSONPath dalam kurung siku mempersempit kecocokan dengan sebuah kondisi.

      Parameters

      • inputs: QueryDto

        JSON dan ekspresi JSONPath

      Returns any

      Nilai-nilai yang cocok sebagai daftar

      const names = bitbybit.json.query({ json: model, query: "$.parts[*].name" });
      
    • Menyetel properti prop ke value pada setiap objek yang dicapai ekspresi JSONPath, memberikan salinan JSON yang telah diubah.

      path menunjuk ke objek-objek induk, prop menyebutkan properti padanya: path: "$.parts[*]", prop: "visible" mengubah setiap part. Nilai yang bukan objek memicu error.

      Parameters

      • inputs: SetValueDto

        JSON, jalur ke objek-objek induk, nama properti dan nilai

      Returns any

      Salinan yang diubah

      const hidden = bitbybit.json.setValue({ json: model, path: "$.parts[*]", prop: "visible", value: false });
      
    • Menerapkan beberapa perubahan setValue sekaligus: entri i dari paths, props dan values adalah satu perubahan, diterapkan berurutan ke salinan JSON.

      Parameters

      • inputs: SetValuesOnPathsDto

        JSON dan daftar-daftar yang berpadanan dari jalur, nama properti dan nilai

      Returns any

      Salinan yang diubah

      const updated = bitbybit.json.setValuesOnPaths({ json: model, paths: ["$", "$.parts[0]"], props: ["name", "visible"], values: ["Assembly", false] });
      
    • Mencantumkan path setiap nilai yang cocok dengan ekspresi JSONPath, masing-masing sebagai path lengkap dari root seperti $['parts'][0]['name'], bukan nilai-nilainya sendiri.

      Parameters

      • inputs: PathsDto

        JSON dan ekspresi JSONPath

      Returns any

      Jalur-jalur kecocokan, sebagai daftar string

      const where = bitbybit.json.paths({ json: model, query: "$..radius" });
      

    preview

    • Menyerahkan JSON ke aplikasi yang berjalan untuk ditampilkan dan ditawarkan penyimpanannya sebagai file; aplikasi menentukan tampilan pratinjaunya, dan tidak terjadi apa pun jika nilainya kosong.

      Parameters

      • inputs: JsonDto

        JSON yang akan ditampilkan

      Returns void

      Tidak ada

      bitbybit.json.previewAndSaveJson({ json: model });
      
    • Menyerahkan JSON ke aplikasi yang berjalan untuk ditampilkan; aplikasi menentukan tampilan pratinjaunya, dan tidak terjadi apa pun jika nilainya kosong.

      Parameters

      • inputs: JsonDto

        JSON yang akan ditampilkan

      Returns void

      Tidak ada

      bitbybit.json.previewJson({ json: model });
      

    props

    • Menyetel satu properti tingkat atas objek JSON ke sebuah nilai, memberikan salinan yang telah diubah; input tetap apa adanya dan properti yang belum ada ditambahkan.

      Parameters

      Returns any

      Salinan yang diubah

      const updated = bitbybit.json.setValueOnProp({ json: settings, property: "width", value: 20 });
      
    • Menemukan objek pertama dalam daftar yang propertinya sama dengan nilai yang diberikan, membandingkan dengan kesetaraan ketat, dan mengembalikannya; jika tidak ada yang cocok menghasilkan undefined.

      Untuk apa pun di luar satu properti, gunakan query dengan filter.

      Parameters

      Returns any

      Objek pertama yang cocok, atau undefined

      const part = bitbybit.json.getJsonFromArrayByFirstPropMatch({ jsonArray: parts, property: "name", match: "lid" });
      
    • Membaca satu properti tingkat atas objek JSON; properti yang tidak ada menghasilkan undefined.

      Parameters

      Returns any

      Nilai properti

      const width = bitbybit.json.getValueOnProp({ json: settings, property: "width" });
      

    transform

    • Mengubah nilai apa pun yang kompatibel dengan JSON menjadi teks JSON-nya, dalam satu baris tanpa indentasi, seperti JSON.stringify.

      Parameters

      Returns string

      Teks JSON

      const text = bitbybit.json.stringify({ json: { width: 10, points: [[0, 0, 0], [1, 1, 1]] } });
      
    • Mengubah teks JSON menjadi nilai yang digambarkannya, seperti JSON.parse; teks yang bukan JSON valid memicu error.

      Parameters

      Returns any

      Nilai hasil penguraian

      const points = bitbybit.json.parse({ text: "[[0, 0, 0], [1, 1, 1]]" });